Install with Docker Compose

This guide will have you up running Dragonfly with docker-compose in just a few minutes.

| This guide assumes you have docker and docker-compose installed on your machine. If not, Install Docker and Install Docker Compose before continuing.

Step 1

  1. # Download Official Dragonfly Docker Compose File
  2. wget https://raw.githubusercontent.com/dragonflydb/dragonfly/main/contrib/docker/docker-compose.yml
  4. # Launch the Dragonfly Instance
  5. docker-compose up -d
  7. # Confirm image is up
  8. docker ps | grep dragonfly
  9. # ac94b5ba30a0   docker.dragonflydb.io/dragonflydb/dragonfly   "entrypoint.sh drago…"   45 seconds ago   Up 31 seconds         0.0.0.0:6379->6379/tcp, :::6379->6379/tcp   docker_dragonfly_1
  11. # Log follow the dragonfly container
  12. docker logs -f docker_dragonfly_1

Dragonfly will answer to both http and redis requests out of the box!

You can use redis-cli to connect to localhost:6379 or open a browser and visit http://localhost:6379

Step 2

Connect with a redis client.

From a new terminal:

  1. redis-cli
  2. 127.0.0.1:6379> set hello world
  3. OK
  4. 127.0.0.1:6379> keys *
  5. 1) "hello"
  6. 127.0.0.1:6379> get hello
  7. "world"
  8. 127.0.0.1:6379>

Step 3

Continue being great and build your app with the power of Dragonfly!

Tuning Dragonfly

If you are attempting to tune Dragonfly for performance, consider NAT performance costs associated with containerization.

Performance Tuning

In docker-compose, there is a meaningful difference between an overlay network(which relies on docker NAT traversal on every request) and using the host network(see docker-compose.yml).

Fore more information, see the official docker-compose network_mode Docs