Skip to content

Installation

Multiple ways to install redisctl depending on your platform and preferences.

The easiest way to install on macOS or Linux:

brew install redis/homebrew-tap/redisctl

To upgrade:

brew upgrade redisctl

Docker

Run without installing anything:

docker run ghcr.io/redis/redisctl --help

For frequent use, create an alias:

alias redisctl='docker run --rm -e REDIS_CLOUD_API_KEY -e REDIS_CLOUD_SECRET_KEY ghcr.io/redis/redisctl'

See the Docker guide for more details.

Cargo (From Source)

If you have Rust installed:

cargo install redisctl

With secure credential storage (OS keyring support):

cargo install redisctl --features secure-storage

Installer Scripts

The existing shell and PowerShell installers are available alongside the archives on the CLI release. These examples install redisctl 0.12.1. For another version, select its redisctl-v<VERSION> tag and matching installer. Avoid the repository-wide "latest" link, which may point to the separately released MCP server.

Like the MCP installers, these commands download and execute a release script. Use them only if your environment permits that installation method; use the archive recipes if you prefer to install the binary directly.

macOS / Linux:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/redis/redisctl/releases/download/redisctl-v0.12.1/redisctl-installer.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -c "irm https://github.com/redis/redisctl/releases/download/redisctl-v0.12.1/redisctl-installer.ps1 | iex"

Binary Downloads

The examples below install redisctl 0.12.1 from its CLI release. For another version, choose its redisctl-v<VERSION> release and matching assets. Avoid the repository-wide "latest" link: this workspace releases the CLI and MCP server separately, so "latest" may point to the other application.

These are pinned, published-release examples, not automatically updated "latest" commands. Maintainers check both installation pages using the release checklist.

Archives contain a top-level platform directory. These commands extract it into a temporary directory before installing the binary.

install_dir="$(mktemp -d)"
curl -fL https://github.com/redis/redisctl/releases/download/redisctl-v0.12.1/redisctl-x86_64-unknown-linux-gnu.tar.xz -o "$install_dir/redisctl.tar.xz"
tar -xJf "$install_dir/redisctl.tar.xz" --strip-components=1 -C "$install_dir"
sudo install -m 755 "$install_dir/redisctl" /usr/local/bin/redisctl

Version 0.12.1 does not provide a pre-built Linux ARM64 archive. Build from source with Cargo, or see the Docker guide for container-based installation.

For Alpine and other musl-based hosts, select the musl archive instead of GNU:

install_dir="$(mktemp -d)"
curl -fL https://github.com/redis/redisctl/releases/download/redisctl-v0.12.1/redisctl-x86_64-unknown-linux-musl.tar.xz -o "$install_dir/redisctl.tar.xz"
tar -xJf "$install_dir/redisctl.tar.xz" --strip-components=1 -C "$install_dir"
sudo install -m 755 "$install_dir/redisctl" /usr/local/bin/redisctl

install_dir="$(mktemp -d)"
curl -fL https://github.com/redis/redisctl/releases/download/redisctl-v0.12.1/redisctl-x86_64-apple-darwin.tar.xz -o "$install_dir/redisctl.tar.xz"
tar -xJf "$install_dir/redisctl.tar.xz" --strip-components=1 -C "$install_dir"
sudo install -m 755 "$install_dir/redisctl" /usr/local/bin/redisctl

install_dir="$(mktemp -d)"
curl -fL https://github.com/redis/redisctl/releases/download/redisctl-v0.12.1/redisctl-aarch64-apple-darwin.tar.xz -o "$install_dir/redisctl.tar.xz"
tar -xJf "$install_dir/redisctl.tar.xz" --strip-components=1 -C "$install_dir"
sudo install -m 755 "$install_dir/redisctl" /usr/local/bin/redisctl

Download the Windows x86_64 archive, extract it, and add the directory containing redisctl.exe to your PATH.

Verify Installation

redisctl --version

For the 0.12.1 binary download examples above, the expected output is:

redisctl 0.12.1

Shell Completions

Generate shell completions for tab completion:

redisctl completions bash > ~/.local/share/bash-completion/completions/redisctl

redisctl completions zsh > ~/.zfunc/_redisctl

redisctl completions fish > ~/.config/fish/completions/redisctl.fish

redisctl completions powershell >> $PROFILE

Next Steps