Docker Installation on VyOS

Docker really makes it easier to create, deploy, and run applications by using containers, and containers allow a developer to package up an application with all of the parts it needs, such as libraries and other dependencies, and ship it all out as one package [1].

I would like to share the script vyos-docker-install.sh, which can be used to install Docker on VyOS router. The script is a fork of the script written by Georgi Chompalov.

Your VyOS instance must have an Internet connection before you can actually run the script. The following is an example of such VyOS configuration.

vyos@vyos:~$ configure
[edit]
vyos@vyos# set interfaces ethernet eth0 address '172.17.100.99/24'
vyos@vyos# set protocols static route 0.0.0.0/0 next-hop 172.17.100.1
vyos@vyos# set service ssh listen-address '172.17.100.99'
vyos@vyos# set system name-server '8.8.8.8'

vyos@vyos# commit
vyos@vyos# save
vyos@vyos# exit

Now, open vi editor and copy the content of the script VyOS in to the file vyos-docker-install.sh.

vyos@vyos:~$ sudo su
root@vyos:/home/vyos# vi vyos-docker-install.sh

Assign the script run privilleges.

root@vyos:/home/vyos# chmod +x vyos-docker-install.sh

Run the script vyos-docker-install.sh.

root@vyos:/home/vyos# ./vyos-docker-install.sh

If Docker is installed successfully, you should end up with the message "Docker successfully installed".

1. Docker Testing

To make the test more fun, we will run a docker image running the UrbanTerror game server.

1. VyOS Configuration

Firstly, create a directory /my_server/q3ut4 directory on our yOS docker host machine

vyos@vyos# mkdir -p /my_server/q3ut4

Copy UrT server.cfg config file from existing Urban Terror installation into the directory /my_server/q3ut4 directory.

Finally, run the docker container. It takes a while to download and extract the image.

vyos@vyos# docker run -d --net host -v /my_server/q3ut4:/q3ut4 tomdesinto/urbanterror:4.3.4

1.2 Urban Terror Client Configuration

We will start Urban Terror Client on Debian 10 Linux (IP 172.17.101.7/16).

$ ./Quake3-UrT.x86_64

Enter the game console pressing the key ` and connect to the server (IP address of the eth0 interface of our VyOS instance):

] connect 172.17.100.99:27960

Picture 1 - Urban Terror Client connected to Server Running Within Docker Container on VyOS Instance 

TCPdump started on the host where Urban Terror client is running confirms communication on UDP port 27960 between Urban Terror client (172.17.101.7) and server 172.17.100.99 (VyOS).

$ sudo tcpdump -i eth0 host 172.17.100.99 and port 27960 -n

Picture 2 -  Communication Between Urban Terror Client and Server

End.