unibaktr/vyos repository overview

⁠Vyos Image for the usage with Kathará

⁠How to use the VyOS Docker image in Kathará

⁠Pull the Docker image

docker pull unibaktr/vyos:latest

⁠Create the VyOS node in Kathará

sudo kathara vstart -n vyos --eth 0:A 1:B 2:C 3:D 4:E --privileged --shell vyos --sysctl net.ipv6.conf.all.disable_ipv6=0 -i unibaktr/vyos:latest

Remember to run kathara with sudo as we need to run the VyOS Docker container with privileged rights

⁠Login to the VyOS node

kathara connect -v vyos

⁠How to configure the VyOS router

If you need to login from a Linux terminal to vbash, the credentials are vyos/vyos

After connecting to the node you can run VyOS commands such as:

• show configuration/interfaces...
• configure
• set interfaces ethernet eth0 address dhcp/static (10.0.0.1/24)
• commit
• exit

At the moment, the VyOS image supports at most 5 interfaces eth0-eth4.

⁠Configure VyOS with a configuration file in Kathará

In any lab.conf add the following for a vyos router:

vyos[0]="A"
vyos[image]="unibaktr/vyos:latest"
vyos[shell]="vyos"
vyos[sysctl]="net.ipv6.conf.all.disable_ipv6=0"

⁠Configure VyOS with an init script in Kathará

Add the file init.vbash to the vyos folder of your kathara node with the content

#!/bin/vbash
source /opt/vyatta/etc/functions/script-template

show interfaces

Now, you can add any VyOS commands to configure the router during its bootstrap process.

⁠Start the laboratory

After starting the laboratory with sudo kathara lstart --privileged, login to each vyos router with kathara connect --logs vyos. After the first login the initial configuration will be set up.