madflojo/redis-tls-dockerfile

Redis + TLS Docker image

Redis with TLS Dockerfile

This project produces an Open Source Redis Docker image with TLS support. This project uses the base Open Source Redis docker image and stunnel to create a TLS wrapped Redis instance.

Using this Image

Start Redis with TLS:

$ docker run -d -p 6379:6379 -v /path/to/certs:/certs --name redis-tls madflojo/redis-tls

The /path/to/certs should be a directory on the host that contains the appropriate cert.pem and key.pem files for stunnel to provide TLS encryption.

Require password authentication for Redis:

$ docker run -d -p 6379:6379 -v /path/to/certs:/certs --env REDIS_PASS="<<password here>>" \
  --name redis-tls madflojo/redis-tls

Use the $REDIS_PASS environment variable to require clients to authenticate with this Redis server.

Additional Options to Redis Start Command:

$ docker run -d -p 6379:6379 -v /path/to/certs:/certs --env REDIS_PASS="<<password here>>" \
  --env REDIS_CMD_OPTS="--appendonly yes"  --name redis-tls madflojo/redis-tls

Use the $REDIS_CMD_OPTS environment variable to pass any command-line arguments to the Redis server start command.

Start with Persistence:

$ docker run --restart=always -d -p 6379:6379 -v /path/to/certs:/certs \ 
  -v /hostpath/to/redisdatabackup:/data --env REDIS_PASS="<<password here>>" \ 
  --name redis-tls madflojo/redis-tls

To retain data throughout container restarts, use Docker's volume maps to mount the data directory to a host-level directory.

Contributing

Thank you for your interest in helping develop this project. The time, skills, and perspectives you contribute to this project are valued.

How can I contribute?

Bugs, Proposals, Feature Requests, and Questions are all welcome by creating an Issue or using Discussions. Please provide as much detail as you can in your request.