🌱Aadam's Garden


Search IconIcon to open search

How to run Althea testnet locally using Docker

Last updated Jan 3, 2023

This guide will show how to run a local testnet for Althea using Docker.

# Prerequisites

I’m starting with a clean Ubuntu install.

# Install Wireguard

sudo apt-get update && sudo apt install -y wireguard linux-source linux-headers-$(uname -r) build-essential && sudo modprobe wireguard

# Clone Repo

git clone --recurse-submodules git@github.com:aadimator/althea_local.git
cd althea_local

# Run bash script

Make sure that you’re in the althea_local directory.

bash start.sh

This will build a Docker image, using the althea_rs repository, and configure all the different components needed to run Althea. In the end, it will run a Docker container and open the bash shell, where all the required dependencies and environment variables have been set.

Whenever you want to launch into the development environment, you’ll have to execute the above script.

# Test

To test that everything is set up correctly, run the following integration test inside the container shell:

python3 althea_rs/integration-tests/integration-test-script/rita.py

This command will execute the official integration tests of althea_rs repository, testing the integration of different components. If all tests pass, you can be sure that everything is set up correctly.

# Environment Variables

Values of different environment variables can be changed in env.list file.