# Prerequisites and operating systems

This article explains:

  • How to install all necessary prerequisites
  • Important notes of installing docker for first time
  • How to setup your environment before running a node

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:

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 https://download.docker.com/linux/ubuntu/gpg | 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] https://download.docker.com/linux/ubuntu \
 $(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 containerd.io
  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 "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(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 CudosNode (opens new window), CudosBuilders (opens new window), and CudosGravityBridge (opens new window) repositories with renaming the folders accordingly to exactly CudosNode, CudosBuilders, and CudosGravityBridge:
git clone --depth 1 --branch gravity/sdk-0.43 https://github.com/CudoVentures/cudos-node.git CudosNode
git clone --depth 1 --branch sdk-0.43  https://github.com/CudoVentures/cudos-builders.git CudosBuilders
git clone --depth 1 --branch cosmos-sdk-0.43 https://github.com/CudoVentures/cosmos-gravity-bridge.git 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.

# Create an account and set up a Keplr wallet

  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. Create an account by running the command (write the mnemonic phrase in a safe place):
cudos-noded keys add <myKeyName>
  1. Follow the guide Set up a Keplr wallet and link it to your account on the Cudos testnet network

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: