Building VyOS ISO Images

Posted on 11th of Apr, 2023 • VyOS

To start with, I'm assuming you have a fresh Debian 11 (Bullseye) server.

1) First, update/upgrade your server.

apt update && apt upgrade -y

2) Next, install Docker-CE (its far simpler to use Docker for this, than trying to work out the required dependancies)

apt-get install -y apt-transport-https ca-certificates curl sudo gnupg2 software-properties-common
curl -fsSL | sudo apt-key add -
add-apt-repository "deb [arch=amd64] $(lsb_release -cs) stable"
apt-get update
apt-get install -y docker-ce

3) Now we'll clone the "vyos-build" repository.

For Version 1.3

git clone -b equuleus --single-branch

For Version 1.4

git clone -b current --single-branch

4) Swap directory into the repo we've just cloned.

cd vyos-build/

5) Next we'll pull and enter the VyOS Build container

For Version 1.3

docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos/vyos-build:equuleus bash

For Version 1.4

docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos/vyos-build:current bash

5.5) For VyOS Version 1.3 only, we'll need to configure the build

./configure --architecture amd64 --build-by ""

6) Finally, we can start building

For Version 1.3

make iso

For Version 1.4

./build-vyos-image iso --architecture amd64 --build-by ""

The build process can take some time and is dependant on your hardware, with decent hardware you should expect this to take around 15-20mins, on older equipment, you can expect it to run for over an hour.

The ISO should now build and once done, will be available in the "vyos-build/build/" directory.