Skip to main 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 https://github.com/worldwide-asset-exchange/wax-blockchain.git

  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.

danger
Important: Refer to [Known Issues](/docs/troubleshooting/) if you encounter an issue with the build or use our [Docker Images](/docs/dapp-development/docker-setup/) instead (recommended). Building from source is not supported.

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

    ./wax_build.sh -i ~/wax-blockchain
    tip
    Tip: This installs [Blockchain Tools](/docs/tools/blockchain_tools) to the wax-blockchain/bin directory.

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

    ./wax_install.sh

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

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