Resources » Redis

Resource Creation

You can create redis databases using the convox resources create command:

$ convox resources create redis
Creating redis-3785 (redis)... CREATING

This will provision Redis on the Amazon ElastiCache. Creation can take a few minutes. To check the status use convox resources info.

Additional Options

--automatic-failover-enabledEnable automatic failover (requires num-cache-clusters > 1)
--database=appThe name of the database to create
--instance-type=cache.t2.microElastiCache instance type to use
--name=<name>The name of the resource to create
--num-cache-clusters=1Number of cache clusters to create (one read-write, rest read-only)
--privateCreate in private subnets

Resource Information

To see relevant info about the database, use the convox resources info command:

$ convox resources info redis-3785
Name    redis-3785
Status  running
URL     redis://

Resource Linking

You can add this URL as an environment variable to any application with convox env set:

$ convox env set REDIS_URL='redis://' --app example-app

Resource Deletion

To delete the database, use the convox resources delete command:

$ convox resources delete redis-3785
Deleting redis-3785... DELETING

Deleting the database will take several minutes.

This action will cause an unrecoverable loss of data.