Skip to content

Docker Image

If youโ€™ve previously found the idea of setting up a Dusk node daunting due to the extensive setup instructions, we have good news. Thanks to Docker, we can provide a process that is greatly simplified. This guide will take you through the process using Docker, allowing you to run your own local Dusk node.


  1. ๐Ÿณ Docker: If you donโ€™t have Docker installed, please follow the official guide
  2. ๐Ÿ›œ Internet Connection: Required to download the Docker image and necessary files.
  3. ๐Ÿ› ๏ธ Git: Optional, but recommended. Useful for retrieving the node code. Git can be downloaded here.
  4. ๐Ÿ’ป Terminal: To execute the steps in the Step-By-Step below, you will need to use a terminal application.
  5. ๐ŸŽ›๏ธ x86-AMD64: To create the Docker Image, a processor with the x86-AMD64 architecture is required.

Step-by-Step Instructions

1. Get the Dusk node files

The Dusk Node is called Rusk. There are two way to get the software, cloning the repository using git, or simply downloading from github

Execute the following commands on the terminal:

Terminal window
git clone
Without Git
  1. Go to the Rusk Github repository.
  2. Click the green โ€œCodeโ€ button and choose โ€œDownload ZIPโ€.
  3. Extract the ZIP file.

2. Build the Docker Image

With Docker installed and the repository files obtained, letโ€™s build the Docker image. Note that this can take 15 to 20 minutes.

The following command will download all the required dependencies and set up the environment for your Dusk node.

Terminal window
docker build -t rusk .

3. Run the Dusk node with Docker

Once the image is built, you can run a Dusk node simply by running in your terminal:

Terminal window
docker run -p 9000:9000/udp -p 8080:8080/tcp rusk

Your node should now be running and giving you output on the blocks it is creating and validating.