dragonfly/docs/build-from-source.md

76 lines
1.6 KiB
Markdown
Raw Normal View History

# Build DragonflyDB From Source
## Running the server
Dragonfly runs on linux. We advice running it on linux version 5.11 or later
but you can also run Dragonfly on older kernels as well.
> :warning: **Dragonfly releases are compiled with LTO (link time optimization)**:
Depending on the workload this can notably improve performance. If you want to
benchmark Dragonfly or use it in production, you should enable LTO by giving
`blaze.sh` the `-DCMAKE_CXX_FLAGS="-flto"` argument.
## Step 1 - install dependencies
On Debian/Ubuntu:
```bash
sudo apt install ninja-build libunwind-dev libboost-fiber-dev libssl-dev \
2023-05-29 10:55:48 +00:00
autoconf-archive libtool cmake g++ libzstd-dev bison libxml2-dev
```
On Fedora:
```bash
sudo yum install automake boost-devel g++ git cmake libtool ninja-build libzstd-devel \
2023-05-29 10:55:48 +00:00
openssl-devel libunwind-devel autoconf-archive patch bison libxml2-devel
```
## Step 2 - clone the project
```bash
git clone --recursive https://github.com/dragonflydb/dragonfly && cd dragonfly
```
## Step 3 - configure & build it
```bash
# Configure the build
./helio/blaze.sh -release
# Build
cd build-opt && ninja dragonfly
```
## Step 4 - voilà
```bash
# Run
./dragonfly --alsologtostderr
```
Dragonfly DB 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 5
Connect with a redis client
```bash
redis-cli
127.0.0.1:6379> set hello world
OK
127.0.0.1:6379> keys *
1) "hello"
127.0.0.1:6379> get hello
"world"
127.0.0.1:6379>
```
## Step 6
Continue being great and build your app with the power of DragonflyDB!