`heroku redis` ============== manage heroku redis instances * [`heroku redis [DATABASE]`](#heroku-redis-database) * [`heroku redis:cli [DATABASE]`](#heroku-rediscli-database) * [`heroku redis:credentials [DATABASE]`](#heroku-rediscredentials-database) * [`heroku redis:info [DATABASE]`](#heroku-redisinfo-database) * [`heroku redis:keyspace-notifications [DATABASE]`](#heroku-rediskeyspace-notifications-database) * [`heroku redis:maxmemory [DATABASE]`](#heroku-redismaxmemory-database) * [`heroku redis:promote [DATABASE]`](#heroku-redispromote-database) * [`heroku redis:stats-reset [DATABASE]`](#heroku-redisstats-reset-database) * [`heroku redis:timeout [DATABASE]`](#heroku-redistimeout-database) * [`heroku redis:upgrade [DATABASE]`](#heroku-redisupgrade-database) * [`heroku redis:wait [DATABASE]`](#heroku-rediswait-database) ## `heroku redis [DATABASE]` gets information about redis ``` USAGE $ heroku redis [DATABASE] -a [--prompt] [-j] [-r ] ARGUMENTS [DATABASE] name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app. FLAGS -a, --app= (required) [env: HEROKU_APP] app to run command against -j, --json output in json format -r, --remote= git remote of app to use GLOBAL FLAGS --prompt interactively prompt for command arguments and flags DESCRIPTION gets information about redis ALIASES $ heroku redis ``` ## `heroku redis:cli [DATABASE]` opens a redis prompt ``` USAGE $ heroku redis:cli [DATABASE] -a [--prompt] [-c ] [-r ] ARGUMENTS [DATABASE] name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app. FLAGS -a, --app= (required) [env: HEROKU_APP] app to run command against -c, --confirm= -r, --remote= git remote of app to use GLOBAL FLAGS --prompt interactively prompt for command arguments and flags DESCRIPTION opens a redis prompt EXAMPLES $ heroku redis:cli --app=my-app my-database $ heroku redis:cli --app=my-app --confirm my-database ``` _See code: [src/commands/redis/cli.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/redis/cli.ts)_ ## `heroku redis:credentials [DATABASE]` display credentials information ``` USAGE $ heroku redis:credentials [DATABASE] -a [--prompt] [-r ] [--reset] ARGUMENTS [DATABASE] name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app. FLAGS -a, --app= (required) [env: HEROKU_APP] app to run command against -r, --remote= git remote of app to use --reset reset credentials GLOBAL FLAGS --prompt interactively prompt for command arguments and flags DESCRIPTION display credentials information ``` _See code: [src/commands/redis/credentials.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/redis/credentials.ts)_ ## `heroku redis:info [DATABASE]` gets information about redis ``` USAGE $ heroku redis:info [DATABASE] -a [--prompt] [-j] [-r ] ARGUMENTS [DATABASE] name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app. FLAGS -a, --app= (required) [env: HEROKU_APP] app to run command against -j, --json output in json format -r, --remote= git remote of app to use GLOBAL FLAGS --prompt interactively prompt for command arguments and flags DESCRIPTION gets information about redis ALIASES $ heroku redis ``` _See code: [src/commands/redis/info.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/redis/info.ts)_ ## `heroku redis:keyspace-notifications [DATABASE]` set the keyspace notifications configuration ``` USAGE $ heroku redis:keyspace-notifications [DATABASE] -a -c [--prompt] [-r ] ARGUMENTS [DATABASE] name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app. FLAGS -a, --app= (required) [env: HEROKU_APP] app to run command against -c, --config= (required) set keyspace notifications configuration -r, --remote= git remote of app to use GLOBAL FLAGS --prompt interactively prompt for command arguments and flags DESCRIPTION set the keyspace notifications configuration Set the configuration to enable keyspace notification events: K Keyspace events, published with __keyspace@__ prefix. E Keyevent events, published with __keyevent@__ prefix. g Generic commands (non-type specific) like DEL, EXPIRE, RENAME, ... $ String commands l List commands s Set commands h Hash commands z Sorted set commands t Stream commands x Expired events (events generated every time a key expires) e Evicted events (events generated when a key is evicted for maxmemory) m Key miss events (events generated when a key that doesn't exist is accessed) A Alias for "g$lshztxe", so that the "AKE" string means all the events except "m". pass an empty string ('') to disable keyspace notifications ``` _See code: [src/commands/redis/keyspace-notifications.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/redis/keyspace-notifications.ts)_ ## `heroku redis:maxmemory [DATABASE]` set the key eviction policy when instances reach their storage limit ``` USAGE $ heroku redis:maxmemory [DATABASE] -a -p [--prompt] [-r ] ARGUMENTS [DATABASE] name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app. FLAGS -a, --app= (required) [env: HEROKU_APP] app to run command against -p, --policy= (required) set policy name -r, --remote= git remote of app to use GLOBAL FLAGS --prompt interactively prompt for command arguments and flags DESCRIPTION set the key eviction policy when instances reach their storage limit Available policies for key eviction include: noeviction # returns errors when memory limit is reached allkeys-lfu # removes less frequently used keys first volatile-lfu # removes less frequently used keys first that have an expiry set allkeys-lru # removes less recently used keys first volatile-lru # removes less recently used keys first that have an expiry set allkeys-random # evicts random keys volatile-random # evicts random keys but only those that have an expiry set volatile-ttl # only evicts keys with an expiry set and a short TTL ``` _See code: [src/commands/redis/maxmemory.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/redis/maxmemory.ts)_ ## `heroku redis:promote [DATABASE]` sets DATABASE as your REDIS_URL ``` USAGE $ heroku redis:promote [DATABASE] -a [--prompt] [--as ] [-r ] ARGUMENTS [DATABASE] name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app. FLAGS -a, --app= (required) [env: HEROKU_APP] app to run command against -r, --remote= git remote of app to use --as= name for the Key-Value Store attachment GLOBAL FLAGS --prompt interactively prompt for command arguments and flags DESCRIPTION sets DATABASE as your REDIS_URL ``` _See code: [src/commands/redis/promote.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/redis/promote.ts)_ ## `heroku redis:stats-reset [DATABASE]` reset all stats covered by RESETSTAT (https://redis.io/commands/config-resetstat) ``` USAGE $ heroku redis:stats-reset [DATABASE] -a [--prompt] [-c ] [-r ] ARGUMENTS [DATABASE] name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app. FLAGS -a, --app= (required) [env: HEROKU_APP] app to run command against -c, --confirm= -r, --remote= git remote of app to use GLOBAL FLAGS --prompt interactively prompt for command arguments and flags DESCRIPTION reset all stats covered by RESETSTAT (https://redis.io/commands/config-resetstat) ``` _See code: [src/commands/redis/stats-reset.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/redis/stats-reset.ts)_ ## `heroku redis:timeout [DATABASE]` set the number of seconds to wait before killing idle connections ``` USAGE $ heroku redis:timeout [DATABASE] -a -s [--prompt] [-r ] ARGUMENTS [DATABASE] name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app. FLAGS -a, --app= (required) [env: HEROKU_APP] app to run command against -r, --remote= git remote of app to use -s, --seconds= (required) set timeout value GLOBAL FLAGS --prompt interactively prompt for command arguments and flags DESCRIPTION set the number of seconds to wait before killing idle connections A value of zero means that connections will not be closed. ``` _See code: [src/commands/redis/timeout.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/redis/timeout.ts)_ ## `heroku redis:upgrade [DATABASE]` perform in-place version upgrade ``` USAGE $ heroku redis:upgrade [DATABASE] -a -v [--prompt] [-c ] [-r ] ARGUMENTS [DATABASE] name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app. FLAGS -a, --app= (required) [env: HEROKU_APP] app to run command against -c, --confirm= -r, --remote= git remote of app to use -v, --version= (required) GLOBAL FLAGS --prompt interactively prompt for command arguments and flags DESCRIPTION perform in-place version upgrade ``` _See code: [src/commands/redis/upgrade.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/redis/upgrade.ts)_ ## `heroku redis:wait [DATABASE]` wait for Redis instance to be available ``` USAGE $ heroku redis:wait [DATABASE] -a [--prompt] [-r ] [--wait-interval ] ARGUMENTS [DATABASE] name of the Key-Value Store database. If omitted, it defaults to the primary database associated with the app. FLAGS -a, --app= (required) [env: HEROKU_APP] app to run command against -r, --remote= git remote of app to use --wait-interval= how frequently to poll in seconds GLOBAL FLAGS --prompt interactively prompt for command arguments and flags DESCRIPTION wait for Redis instance to be available ``` _See code: [src/commands/redis/wait.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/redis/wait.ts)_