Skip to content

Install the WAX Blockchain

The GitHub WAX Blockchain Source Code Repository downloads to the wax-blockchain directory. The download and build process can take several minutes to several hours, depending on your Internet connection, operating system, and hardware specifications.

To download the WAX Blockchain Source Code Repository:

  1. From the command line, clone the Git repository.

    git clone
  2. Change the directory to wax-blockchain.

    cd wax-blockchain
  3. Update Git submodules.

    git submodule update --init --recursive

Build the WAX Blockchain

If you're using our Docker images, you do not need to complete these steps.

To build the WAX Blockchain from source, you can use the following steps. If you have a previous version installed, you'll need to uninstall it first. Refer to Uninstall WAX for more information.


Important: Refer to Known Issues if you encounter an issue with the build or use our Docker Images instead (recommended). Building from source is not supported.

  1. Run the build script and set the installation directory.

    ./ -i ~/wax-blockchain


This installs Blockchain Tools to the wax-blockchain/bin directory.

  1. Install WAX to the directory you set in Step 4.

  2. Optional. Add the blockchain tools directory to your path.

    echo "export PATH=~/wax-blockchain/bin:$PATH" >> ~/.bashrc && source ~/.bashrc