Version: Next

ReductStore CLI

The ReductStore CLI is a command line client for ReductStore, a time series database for blob data.

Features

Support for ReductStore API v1.21
Easy management of buckets, tokens, replications and lifecycle policies
Ability to check the status of a storage engine
Aliases for storing server credentials
Export and mirror data

Installing

From Cargo

cargo install --locked reduct-cli

From Snap

sudo snap install reduct-cli

From pre-built binaries

You can also install reduct-cli from the latest release binaries.

Linux (amd64)

wget https://github.com/reductstore/reduct-cli/releases/latest/download/reduct-cli.x86_64-unknown-linux-gnu.tar.gz
tar -xvf reduct-cli.x86_64-unknown-linux-gnu.tar.gz
chmod +x reduct-cli
sudo mv reduct-cli /usr/local/bin

Windows (amd64)

Invoke-WebRequest -Uri https://github.com/reductstore/reduct-cli/releases/latest/download/reduct-cli.x86_64-pc-windows-gnu.zip -OutFile reduct-cli.zip
Expand-Archive -LiteralPath reduct-cli.zip -DestinationPath .
.\reduct-cli.exe

We support many additional platforms. Download binaries and sources from the latest release: GitHub Releases

Usage

Check with our demo server:

reduct-cli alias add play -L  https://play.reduct.store/replica -t reductstore
reduct-cli server status play
reduct-cli bucket ls --full play
reduct-cli cp play/datasets ./datasets --start "now-2h" --stop "now-1h"
reduct-cli cp play/* backup

For more examples, see the Guides section in the ReductStore documentation.

Community & Contribution

If you've found a bug, have ideas, built something with ReductStore CLI, or want to contribute directly, here are the best places to jump in:

Questions and Ideas: Join our Discourse community to ask questions, share ideas, and collaborate with fellow ReductStore users.
Bug Reports: Open an issue on our GitHub repository. Please include the ReductStore CLI version, ReductStore server version, the command you ran, and the output or error message.
First Contributions: Pick a task from good first issues or help wanted.
Pull Requests: Open PRs only for an existing issue. Comment on the issue and get assigned before you start work. Use the repository pull request template when you open the PR, and update CHANGELOG.md for user-visible changes. If you want to propose a new feature or workflow, open an issue first or start the discussion on the community forum before writing code.
Show Your Work: Share your projects, benchmarks, and lessons learned on our Discourse community.
Support the Project: If ReductStore CLI is useful to you, give us a ⭐ on GitHub.