Install software

Installing YugabyteDB involves completing prerequisites and downloading the YugabyteDB package.

Prerequisites

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:

    wget https://downloads.yugabyte.com/releases/2.21.0.0/yugabyte-2.21.0.0-b545-linux-x86_64.tar.gz
    

    Or:

    wget https://downloads.yugabyte.com/releases/2.21.0.0/yugabyte-2.21.0.0-b545-el8-aarch64.tar.gz
    
  2. Extract the package and then change directories to the YugabyteDB home.

    tar xvfz yugabyte-2.21.0.0-b545-linux-x86_64.tar.gz && cd yugabyte-2.21.0.0/
    

    Or:

    tar xvfz yugabyte-2.21.0.0-b545-el8-aarch64.tar.gz && cd yugabyte-2.21.0.0/
    

Configure YugabyteDB

To configure YugabyteDB, run the following shell script:

./bin/post_install.sh