Install software

Installing YugabyteDB involves completing prerequisites and downloading the YugabyteDB package.


Before installing YugabyteDB, ensure that you have the following available:

  1. One of the supported operating systems.

  2. Python 3. To check the version, execute the following command:

    python --version
    Python 3.7.3

    By default, CentOS 8 does not have an unversioned system-wide python command. To fix this, set python3 as the alternative for python by running sudo alternatives --set python /usr/bin/python3.

    Starting from Ubuntu 20.04, python is no longer available. To fix this, run sudo apt install python-is-python3.

  3. wget or curl.

    The instructions use the wget command to download files. If you prefer to use curl, you can replace wget with curl -O.

    To install wget:

    • On CentOS, run yum install wget
    • On Ubuntu, run apt install wget

    To install curl:

    • On CentOS, run yum install curl
    • On Ubuntu, run apt install curl

Download YugabyteDB

YugabyteDB supports both x86 and ARM (aarch64) CPU architectures. Download packages ending in x86_64.tar.gz to run on x86, and packages ending in aarch64.tar.gz to run on ARM.

The following instructions are for downloading the STS (standard-term support) release of YugabyteDB, which is recommended for production deployments. For other versions, see Releases.

Download YugabyteDB as follows:

  1. Download the YugabyteDB package using one of the following wget commands:



  2. Extract the package and then change directories to the YugabyteDB home.

    tar xvfz yugabyte- && cd yugabyte-


    tar xvfz yugabyte- && cd yugabyte-

Configure YugabyteDB

To configure YugabyteDB, run the following shell script: