Skip to content

reductstore/reduct-cli

ReductStore CLI

Crates.io(latest version) GitHub all releases GitHub Workflow Status

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.

Contributors

Thanks to everyone who has contributed to ReductStore CLI.

@atimin @AnthonyCvn @szabgab @vbmade2000 @Rumpelshtinskiy @ychampion @yaslam-dev

Links

About

CLI client for ReductStore

Resources

License

Code of conduct

Contributing

Security policy

Stars

6 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors