# Docker

This instruction will guide you how to install a Relay in Docker for different Linux distributions. The instructions are applicable to both **amd64** and **arm64** architectures, including devices such as the Raspberry Pi.

### The latest Docker image can be found here:

<https://github.com/anyone-protocol/ator-protocol/pkgs/container/ator-protocol>

{% hint style="info" %}
From Anon version 0.4.9.7-live it is required to [accept terms and conditions](https://docs.anyone.io/maintenance/updates#preseed-debconf-database) to run the client.
{% endhint %}

## Step by step installation

Type all the `commands` in a terminal window. Each code block can be pasted in full.

### 1.   Add Docker repository

{% tabs %}
{% tab title="Debian / Ubuntu" %}

```bash
sudo apt-get install ca-certificates curl gnupg -y 
sudo install -m 0755 -d /etc/apt/keyrings
. /etc/os-release
sudo curl -fsSL https://download.docker.com/linux/$ID/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
sudo echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/$ID \
  $(. /etc/os-release && sudo echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
```

{% endtab %}

{% tab title="Fedora" %}

```bash
sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo -y
```

{% endtab %}
{% endtabs %}

### 2.   Install the Docker packages

{% tabs %}
{% tab title="Debian / Ubuntu" %}

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

{% endtab %}

{% tab title="Fedora" %}

```bash
sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
sudo systemctl enable --now docker
```

{% endtab %}
{% endtabs %}

### 3.   Prepare directories and fetch files

<pre class="language-bash"><code class="lang-bash">sudo mkdir /opt/compose-files/
sudo mkdir -p /opt/anon/etc/anon/
sudo mkdir -p /opt/anon/run/anon/
sudo mkdir -p /root/.nyx/
sudo chmod -R 700 /opt/anon/run/anon/
sudo chown -R 100:101 /opt/anon/run/anon/
sudo touch /opt/anon/etc/anon/notices.log
sudo chown 100:101 /opt/anon/etc/anon/notices.log
sudo useradd -M anond
sudo wget -O /opt/compose-files/relay.yaml https://raw.githubusercontent.com/anyone-protocol/anon-install/refs/heads/main/docker/anon-relay/relay.yaml
<strong>sudo wget -O /opt/anon/etc/anon/anonrc https://raw.githubusercontent.com/anyone-protocol/anon-install/refs/heads/main/docker/anon-relay/anonrc
</strong>sudo wget -O /root/.nyx/config https://raw.githubusercontent.com/anyone-protocol/anon-install/refs/heads/main/docker/anon-relay/config
</code></pre>

### 4.   Create and start the Docker container

```bash
sudo docker compose -f /opt/compose-files/relay.yaml up -d
```

#### Done!

***

## Commands for updating, testing and monitoring:

#### Edit relay configuration

```bash
sudo nano /opt/anon/etc/anon/anonrc
```

#### Update relay to run latest version

```bash
sudo docker container rm --force anon-relay
sudo docker pull ghcr.io/anyone-protocol/ator-protocol:latest-manual
sudo docker compose -f /opt/compose-files/relay.yaml up -d
```

#### Install Nyx monitor

{% tabs %}
{% tab title="Debian / Ubuntu" %}

```sh
sudo apt-get install nyx
```

{% endtab %}

{% tab title="Fedora" %}

```bash
sudo dnf install nyx
```

{% endtab %}
{% endtabs %}

#### Monitor relay with Nyx

```bash
sudo nyx -s /opt/anon/run/anon/control
```

#### Check status for containers

```bash
sudo docker ps
```

#### Start, stop and restart the relay container

```bash
sudo docker start anon-relay
sudo docker restart anon-relay
sudo docker stop anon-relay
```

#### Check systemctl logs for anon service

```bash
sudo docker logs anon-relay
```

#### Monitor anon log

```bash
sudo tail -f /opt/anon/etc/anon/notices.log
```

#### Remove the relay container

```bash
sudo docker rm anon-relay --force
```