| 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. |
Overview
redisctl is a unified CLI for managing Redis Cloud, Redis Enterprise, and direct Redis database connections. This skill covers installation, profile setup, and validation.
Installation
Choose one method:
brew install redis/homebrew-tap/redisctl
cargo install redisctl
docker run --rm -it ghcr.io/redis/redisctl --help
Profile Setup
Profiles store connection credentials. Use the interactive wizard for guided setup:
redisctl profile init
Or create profiles directly:
Redis Cloud Profile
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
Redis Enterprise Profile
redisctl profile set ent-staging \
--type enterprise \
--url "https://cluster.internal:9443" \
--username admin \
--password "$RE_PASSWORD"
redisctl profile default-enterprise ent-staging
Direct Database Profile
redisctl profile set local-redis \
--type database \
--url "redis://localhost:6379"
redisctl profile default-database local-redis
Validation
After creating profiles, verify connectivity:
redisctl profile list
redisctl profile show cloud-prod
redisctl profile validate
Shell Completions
Generate completions for your shell:
redisctl completions bash > ~/.bash_completion.d/redisctl
redisctl completions zsh > ~/.zfunc/_redisctl
redisctl completions fish > ~/.config/fish/completions/redisctl.fish
Common Issues
- Credential errors: Check that environment variables are set and profile type matches the command namespace (cloud profile for cloud commands, etc.)
- Enterprise TLS errors: Use
--insecure flag for self-signed certificates during setup
- Config file location: Run
redisctl profile path to find the config file
