Build the source code

• AlmaLinux
• macOS
• CentOS
• Ubuntu

The following instructions are for Ubuntu 20.04 or Ubuntu 22.04.

Install necessary packages

Update packages on your system, install development tools and additional packages:

sudo apt update
sudo apt upgrade -y
packages=(
  autoconf
  build-essential
  curl
  gettext
  git
  locales
  ninja-build
  pkg-config
  rsync
)
sudo apt install -y "${packages[@]}"
sudo locale-gen en_US.UTF-8

Python 3

Python 3.7 or higher is required.

sudo apt install -y libffi-dev python3 python3-dev python3-venv

CMake 3

CMake 3.17.3 or higher is required.

The CMake version in the package manager is too old (3.16), so manually download a release as follows:

mkdir ~/tools
curl -L "https://github.com/Kitware/CMake/releases/download/v3.25.2/cmake-3.25.2-linux-x86_64.tar.gz" | tar xzC ~/tools
# Also add the following line to your .bashrc or equivalent.
export PATH="$HOME/tools/cmake-3.25.2-linux-x86_64/bin:$PATH"

/opt/yb-build

By default, when running build, third-party libraries are not built, and pre-built libraries are downloaded. We also use Linuxbrew to provide some of the third-party dependencies. The build scripts automatically install these in directories under /opt/yb-build. In order for the build script to write under those directories, it needs proper permissions. One way to do that is as follows:

sudo mkdir /opt/yb-build
sudo chown "$(whoami)" /opt/yb-build

Alternatively, specify the build options --no-download-thirdparty and/or --no-linuxbrew. Note that those options may require additional, undocumented steps.

Ninja (optional)

Use Ninja for faster builds.

sudo apt install -y ninja-build

Ccache (optional)

Use Ccache for faster builds.

sudo apt install -y ccache
# Also add the following line to your .bashrc or equivalent.
export YB_CCACHE_DIR="$HOME/.cache/yb_ccache"

Java

YugabyteDB core is written in C and C++, but the repository contains Java code needed to run some tests and sample applications. To build the Java part, you need:

• Java Development Kit (JDK) 8 or 11.
• Apache Maven 3.3 or later.

The maven package satisfies both requirements.

sudo apt install -y maven

yugabyted-ui

yugabyted-ui is a UI for yugabyted. By default, it is not built unless the corresponding build option is specified or a release package is being built. To build it, npm and Go 1.18 or higher are required.

sudo apt install -y npm golang-1.18
# Also add the following line to your .bashrc or equivalent.
export PATH="/usr/lib/go-1.18/bin:$PATH"

Build the code

Assuming this repository is checked out in ~/code/yugabyte-db, do the following:

cd ~/code/yugabyte-db
./yb_build.sh release

The command above will build the release configuration, add the binaries into the build/release-<compiler>-dynamic-ninja directory, and create a build/latest symlink to that directory.

For more details about building and testing, refer to Build and test.

Build release package (optional)

Satisfy requirements for building yugabyted-ui.

Install the following additional packages:

sudo apt install -y file patchelf

Run the yb_release script to build a release package:

$ ./yb_release
......
2023-02-17 01:26:37,156 [yb_release.py:299 INFO] Generated a package at '/home/user/code/yugabyte-db/build/yugabyte-2.17.2.0-ede2a2619ea8470064a5a2c0d7fa510dbee3ce81-release-clang15-ubuntu20-x86_64.tar.gz'

echo "* - nofile 1048576" | sudo tee -a /etc/security/limits.conf