Install from Binary

Below are step by step instructions for running Dragonfly from binary.

Prerequisites

  • You must be running a Linux based OS (if using mac run using Docker). Windows WSL will work as well.
  • Network access
  • Minimum 4GB of RAM to get the benefits of Dragonfly
  • Minimum 1 CPU Core
  • Linux Kernel 4.19 or higher

Download preferred file

You can download the latest Dragonfly release from one of the links below. You can also checkout all releases here.

Uncompress and rename

Next we need to uncompress the file and rename it to ‘dragonfly’

  1. tar zxf {file_name}
  2. mv {file_name} dragonfly

Run Dragonfly

Run the following command to run Dragonfly.

  1. ./dragonfly --logtostderr

Run Dragonfly with parameters

The list of supported flags for Dragonfly can be seen by running “—help” option.

The full list of options can be seen by running “—helpfull” option.

The most useful options can be found here.

For example to run dragonfly with:

  • Log message at standard error
  • Password (set to youshallnotpass)
  • Cache mode enabled
  • Number of db set to 1
  • Listen on port 6379 and local host traffic only
  • Persist data at 30 minutes intervals
  • Max memory set to 12GB
  • The number of keys that the “KEY” commands return (set to 12288)
  • Set the dump file name (to dump.db)

You would run:

  1. dragonfly --logtostderr --requirepass=youshallnotpass --cache_mode=true -dbnum 1 --bind localhost --port 6379  --save_schedule "*:30" --maxmemory=12gb --keys_output_limit=12288 --dbfilename dump.rdb

Flag files

Flags can be also provided from a configuration file with the --flagfile <filename> flag. The file should list one flag per line, with equal signs instead of spaces for key-value flags.