Compile from source

Since 2.4.0, Pegasus supports to build both on Linux and macOS. Please don’t hesitate to contact us via Github Issues when you encountered any problem.


  • GCC 5+
  • CMake 3.11+

Ubuntu environment

You can refer to the docker image pegasus-build-dev/ubuntu20.04 to install all dependencies.

apt-get update -y; \
apt-get install -y --no-install-recommends \
                       build-essential \
                       software-properties-common \
                       clang-10 \
                       openjdk-8-jdk \
                       python3-pip \
                       libaio-dev \
                       libsnappy-dev \
                       libbz2-dev \
                       libzstd-dev \
                       liblz4-dev \
                       zlib1g \
                       patch \
                       netcat \
                       wget \
                       ccache \
                       git \
                       curl \
                       zip \
                       unzip \
                       gdb \
                       vim \
                       automake \
                       libtool \
                       libssl-dev \
                       bison \
                       maven \

pip3 install --no-cache-dir cmake

CentOS environment

You can refer to the docker image pegasus-build-dev/centos7 to install all dependencies.

yum -y install centos-release-scl \
                   scl-utils \
                   epel-release; \
                   yum -y install devtoolset-7-gcc \
                   devtoolset-7-gcc-c++ \
                   java-1.8.0-openjdk-devel.x86_64 \
                   python3 \
                   automake \
                   autoconf \
                   make \
                   libtool \
                   git \
                   file \
                   wget \
                   ccache \
                   nmap-ncat \
                   zip \
                   gdb \
                   vim \
                   unzip \
                   which \
                   openssl-devel \
                   libaio-devel \
                   snappy-devel \
                   bzip2-devel \
                   zlib \
                   zlib-devel \
                   libzstd-devel \
                   lz4-devel \
                   bison \
                   flex \

pip3 install --no-cache-dir cmake


Firstly, make sure:

  • maven has been installed correctly and added to PATH
  • devtoolset-7 has been added to PATH
  • JAVA_HOME has been set correctly

Please refer to Downloads to fetch the sources。

./ build -c

The output of compilation will be placed under DSN_ROOT of the source directory. It includes bin, include and lib.


Package server binaries for deployment:

./ pack_server

Package client libraries for C/C++ development:

./ pack_client

Package toolset which includes various tools (shell, bench):

./ pack_tools

If this is your first time compiling Pegasus, it’s recommended to try onebox.

Apache Incubator
Copyright © 2020 The Apache Software Foundation. Licensed under the Apache License, Version 2.0.

Apache Pegasus is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.