The SlateDB Admin CLI provides an interface for managing and maintaining SlateDB databases. It enables direct interaction with SlateDB manifests, checkpoints, and garbage collector.

Installation#

You can install the SlateDB CLI using Cargo. Run:

cargo install --locked slatedb-cli

Alternatively, build from source by cloning the repository and compiling the CLI:

git clone https://github.com/slatedb/slatedb.git
cd slatedb
cargo build --release -p slatedb-cli

The resulting binary will be available at target/release/slatedb.

Setup#

The CLI requires environment variables to configure access to your object store. You can set these variables in your shell environment or provide them via a .env file using the --env-file option. The required variables depend on your object store provider. See admin.rs for details.

Every command requires the --path option, which specifies the root directory in your object store.

Usage#

Run the CLI with slatedb --help to see a list of available commands and options.

Run the standalone compactor#

Run compaction as a standalone process (instead of inside your Db clients):

slatedb --env-file .env --path <db-path> run-compactor

The compactor runs until interrupted (Ctrl-C), then shuts down gracefully.

See Run a Standalone Compactor for how to disable the embedded compactor in your database clients.