CLI

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.

Note

The compactor expects the database to already exist (a manifest must be present). If you’re creating a new database, open it once before starting the compactor.

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