How to run Althea testnet locally using Docker

Last updated Jan 3, 2023

• Type note
• Status unfinished
• On docker
• On networks manet

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

I’m starting with a clean Ubuntu install.

• Ubuntu 22.10
• docker-ce
  • Follow the instructions Things to do after installing Ubuntu > Docker to set it up.
  • Make sure that you are using docker-ce instead of Docker Desktop. I wasn’t able to run it using Docker Desktop, and upon suggestion by Althea developer, using docker-ce results in all tests succeeding.

1

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

1
2

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

Make sure that you’re in the althea_local directory.

1

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.

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

1

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.

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