Install with Docker

Starting with docker run is the simplest way to get up and running with Dragonfly.

If you do not have docker on your machine, Install Docker before continuing.

Step 1

On linux

  1. docker run --network=host --ulimit memlock=-1 docker.dragonflydb.io/dragonflydb/dragonfly

On macOS

network=host doesn’t work well on macOS, see this issue

  1. docker run -p 6379:6379 --ulimit memlock=-1 docker.dragonflydb.io/dragonflydb/dragonfly

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

NOTE: On some configurations, running with the docker run --privileged ... flag can fix some initialization errors.

Step 2

Connect with a redis client

  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!