This article explains:

Install prerequisites

You can run your node in different operating systems such as Debian 10, Ubuntu, WSL, and macOS Catalina version 10.15.4 or above. If you are installing docker for the first time, please check the next section, “Notes for Installing Docker for the First Time”.

The first step is to ensure that you have set up all requirements and prerequisites as the following:

apt update
apt install -y jq

Missing any of the prerequisites above can lead to errors and being unable to run your node. It is recommended to have the latest version of Docker and Docker compose installed. If you already installed them, you can check the version by running the following commands in your terminal:

sudo docker -v
sudo docker-compose -v

Notes for installing docker for the first time

Before installing the Docker Engine for the first time on a new host machine, you need to set up the Docker repository. Afterwards, you can install and update Docker from the repository.

  1. Set up the repository, update the apt package index, and install packages to allow apt to use a repository over HTTPS:
apt-get update
apt-get install \
   apt-transport-https \
   ca-certificates \
   curl \
   gnupg \
  1. Add Docker’s official GPG key:
curl -fsSL | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
  1. Set up the stable repository:
echo \
 "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] \
 $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list
> /dev/null
  1. Install the Docker Engine
apt-get update
apt-get install docker-ce docker-ce-cli
  1. Verify that the Docker Engine is installed
docker run hello-world
  1. Install Docker Compose:
### For alpine, the following dependency packages are needed: py-pip, python3-dev, libffi-dev, openssl-dev, gcc, libc-dev, rust, cargo and make ###

apt install py-pip python3-dev libffi-dev openssl-dev gcc libc-dev rust cargo make

# apt install py-pip python3-dev libffi-dev openssl-dev gcc libc-dev rust cargo make
  1. Download the current stable release of Docker Compose:
curl -L "$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
  1. Apply executable permissions to the binary:
chmod +x /usr/local/bin/docker-compose

Note that if you can not connect to the Docker daemon, you can automatically start the docker daemon at boot by running the command:

systemctl enable --now docker and then check the status:  systemctl status docker

Note that depending on the operating system which you are using, there can be some additional steps to take. For example, removing any "distro-specific" docker components first in case of a Linux OS because of a wide variety of options and combinations. Please check official vendor documentation:

Setup the environment before running a node

After installing all prerequisites, you can start to set up the environment:

  1. Create a directory to use as your workspace:
mkdir ~/cudos
cd ~/cudos
  1. Make sure that you are in the correct directory (cudos directory in this example)
  2. Clone the correct branches from the CudosNodeopen in new window, CudosBuildersopen in new window, and CudosGravityBridgeopen in new window repositories with renaming the folders accordingly to exactly CudosNode, CudosBuilders, and CudosGravityBridge:
git clone --depth 1 --branch v0.4.0 CudosNode
git clone --depth 1 --branch v0.3.3 CudosBuilders
git clone --depth 1 --branch v0.4.0 CudosGravityBridge
  1. Navigate to the CudosBuilders directory
  2. Build the docker image of the binary by running the command:
cd docker/binary-builder && sudo docker-compose --env-file binary-builder.arg -f binary-builder.yml -p cudos-binary-builder up --build --detach

Note that you need to repeat the same steps for each node that you want to create.


A node is using several ports in order to function properly. Here is a list of ports and their descriptions:

  • 1317: API port.
  • 9090: gRPC port.
  • 26656: P2P port used by transferring internal data between nodes.
  • 26657: Tendermint RPC server. Reference:
  • 26660: Port for Prometheus monitoring.

Full/Seed nodes use the following ports: 26656, 26657, 26660.

Sentry nodes use the following ports: 1317, 9090, 26656, 26657, 26660.

The Docker instance is binding the above ports to your host machine automatically, so you just have to open the following ports on your machine where the Cudos nodes are running.

Create an account and set up a Keplr wallet (Only in the Validator node)

  1. You can use the docker terminal to locate the containers' ID:
sudo docker ps --filter "name=binary-builder"
  1. Copy the CONTAINER_ID and create the CUDOS_NODED instance by running the command:
alias cudos-noded='sudo docker exec -it binary-builder cudos-noded'
  1. Follow the guide Set up a Keplr wallet and link it to your account on the Cudos testnet network
  2. Create an account by running the command (write the mnemonic phrase in a safe place):
cudos-noded keys add validator --recover --keyring-backend="os"

Note that the cudos-noded is a command-line interface. It is the same command-line interface used for deploying smart contracts. You can get the list of all commands by running: