mirror of
https://github.com/nickyeoman/docker-compose-cookbooks.git
synced 2026-09-04 10:56:23 +00:00
- Rename docker-compose.yml to compose.yaml - Add REDIS_HEALTHCHECK_INTERVAL and REDIS_HEALTHCHECK_TIMEOUT env vars - Update README.md with comprehensive information - Add VOL_PATH volume configuration - Add external/internal network declaration
63 lines
1.7 KiB
Markdown
63 lines
1.7 KiB
Markdown
# Redis
|
||
|
||
## Overview
|
||
|
||
Redis is an open-source in-memory data structure store used as a database, cache, and message broker. It's highly popular for its performance and versatility.
|
||
|
||
## Project Details
|
||
|
||
- **Project Repository:** https://github.com/redis/redis
|
||
- **Container Image:** [Docker Hub](https://hub.docker.com/_/redis)
|
||
- **Compose Example:** [Redis Docker Compose](https://github.com/redis/redis/tree/7.0/utils#docker)
|
||
- **Documentation:** [Redis Docs](https://redis.io/docs/)
|
||
- **Reverse Proxy Port:** `6379`
|
||
|
||
## Getting Started
|
||
|
||
1. Start the container: `docker compose up -d`
|
||
2. Connect to Redis using: `redis-cli -h localhost -p 6379`
|
||
|
||
## Environment Variable Notes
|
||
|
||
- `REDIS_IMAGE` – Redis Docker image to use (default: `redis:alpine`)
|
||
- `REDIS_PORT` – Redis port to expose (default: `6379`)
|
||
- `TZ` – Timezone for container (default: `UTC`)
|
||
|
||
## Volume Notes
|
||
|
||
- `/data` – Persistent Redis data directory ( stores Redis data on disk via save configuration)
|
||
|
||
## Network Notes
|
||
|
||
Requires proxy network
|
||
|
||
## Docker Run
|
||
|
||
```bash
|
||
docker run -d \
|
||
--name redis \
|
||
-e REDIS_IMAGE=redis:alpine \
|
||
-e REDIS_PORT=6379 \
|
||
-e TZ=UTC \
|
||
-v ${VOL_PATH:-/data}/redis:/data \
|
||
-p 6379:6379 \
|
||
redis:alpine
|
||
```
|
||
|
||
## Additional Notes / Gotchas
|
||
|
||
- Make sure to configure persistence in your Redis setup using the `save` configuration
|
||
- Use `docker compose exec redis redis-cli` to access the running container
|
||
- Remember to set a strong `redis-cli` password if using Redis in production
|
||
|
||
## Dockhand Stack, Deploy from Git
|
||
|
||
Cookbooks Repository
|
||
stackname: redis
|
||
Compose file path: redis_dev/compose.yaml
|
||
Additional env file (optional): redis_dev/sample.env
|
||
|
||
Then "Load" redis_dev/sample.env into the Environmental variables in dockhand
|
||
|
||
Create the Stack
|