// Install and configure redisctl CLI for Redis Cloud, Enterprise, and direct database access. Use when setting up redisctl for the first time, creating profiles, or configuring shell completions.
| name | redisctl-setup |
| description | Install and configure redisctl CLI for Redis Cloud, Enterprise, and direct database access. Use when setting up redisctl for the first time, creating profiles, or configuring shell completions. |
redisctl is a unified CLI for managing Redis Cloud, Redis Enterprise, and direct Redis database connections. This skill covers installation, profile setup, and validation.
Choose one method:
# Homebrew (macOS/Linux)
brew install redis-developer/tap/redisctl
# Cargo (from source)
cargo install redisctl
# Docker
docker run --rm -it ghcr.io/redis/redisctl --help
Profiles store connection credentials. Use the interactive wizard for guided setup:
redisctl profile init
Or create profiles directly:
redisctl profile set cloud-prod \
--type cloud \
--api-key "$REDIS_CLOUD_API_KEY" \
--api-secret "$REDIS_CLOUD_API_SECRET"
redisctl profile default-cloud cloud-prod
redisctl profile set ent-staging \
--type enterprise \
--url "https://cluster.internal:9443" \
--username admin \
--password "$RE_PASSWORD"
redisctl profile default-enterprise ent-staging
redisctl profile set local-redis \
--type database \
--url "redis://localhost:6379"
redisctl profile default-database local-redis
After creating profiles, verify connectivity:
# List all profiles
redisctl profile list
# Show a specific profile
redisctl profile show cloud-prod
# Validate connectivity for all profiles
redisctl profile validate
Generate completions for your shell:
# Bash
redisctl completions bash > ~/.bash_completion.d/redisctl
# Zsh
redisctl completions zsh > ~/.zfunc/_redisctl
# Fish
redisctl completions fish > ~/.config/fish/completions/redisctl.fish
--insecure flag for self-signed certificates during setupredisctl profile path to find the config file