Configuring Worker Using Existing NoPASARAN Coordinator

1. Visit the Docker Documentation

Go to the official Docker documentation for reference:

2. Add Docker’s Official GPG Key

Below is an example for Ubuntu. Adjust commands as necessary for your specific operating system.

sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

Add the Docker repository to your system’s Apt sources:

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo \"${UBUNTU_CODENAME:-$VERSION_CODENAME}\") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update

3. Save & Execute the Docker Installation Script

Create or save a script with the commands from the previous step, then run it. For example:

# Paste the commands from above into shell.sh, then save and exit.
nano shell.sh

bash shell.sh

4. Install Docker Packages

Run the following command to install Docker and related components:

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

5. Log in to a Coordinator

Go to your coordinator (below we assume that we use the official one):

NoPASARAN Coordinator

Enter your credentials to access your NoPASARAN dashboard.

6. Identify Your Target Worker

  • Find the name of the worker that you want to configure your device to use.

7. Open the Worker Settings

  • Click the Settings icon for your chosen worker (hover over it to see Configure endpoint).

8. Copy the Configuration

  • Press the Copy configuration button to copy the Docker configuration details.

10. Create a Docker Compose File

Create a file named docker-compose.yml:

nano docker-compose.yml

Paste the copied configuration into this file.

11. Install Docker Compose (If Not Already Installed)

If Docker Compose is not already installed, you can do so with:

sudo apt install docker-compose

12. Add Your User to the Docker Group

Give your user permissions to run Docker commands without using sudo each time:

sudo usermod -aG docker $(whoami)

13. Reboot the Device

Reboot your system to apply group membership changes:

sudo reboot

14. Start the Docker Compose Service

After the reboot, return to your Downloads folder (or wherever docker-compose.yml is saved) and run:

docker-compose up