In this article

This article explains how to manually update a DNS Relay running on Ubuntu 18.04 when Relay containers do not automatically refresh to the latest image.

⚠️ Important: Ubuntu 18.04 is no longer a recommended platform. For long-term stability, we suggest upgrading to Ubuntu 22.04 and redeploying your Relay using the latest image from the DNSFilter dashboard. If you need to remain on 18.04 temporarily, follow the steps below.

Update Process

1. Clean up old Docker images (optional)

Free up disk space by removing unused images:

sudo docker image prune -a --force --filter "until=24h"

2. Pull the latest Relay image

sudo docker pull dnsfilter/relay:latest

3. Verify running containers

Confirm which containers are active (typically relay1 and relay2):

sudo docker ps

4. Update Relay 1

Stop and remove the container:

sudo docker stop relay1
sudo docker rm relay1

Recreate it with Ansible (run without sudo):

ansible-playbook /etc/ansible/relay.yml

Check it’s running:

sudo docker ps

5. Update Relay 2

Repeat the same process for the second container:

sudo docker stop relay2
sudo docker rm relay2
ansible-playbook /etc/ansible/relay.yml
sudo docker ps

6. Final checks

Confirm both containers are running:

sudo docker ps

Verify in the DNSFilter dashboard that both Relays appear healthy and up to date.

Troubleshooting

• Ansible won’t connect to localhost. Ensure you are not running the playbook with sudo

• Container not found. Run this command to confirm container names:

  sudo docker ps --format '{{.Names}}'

• Old image still used. Ensure you ran docker pull dnsfilter/relay:latest before recreating containers