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 https://download.docker.com/linux/debian/gpg | sudo apt-key add -
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(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 https://github.com/vyos/vyos-build
For Version 1.4
git clone -b current --single-branch https://github.com/vyos/vyos-build
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 "rod@rod.ac"
6) Finally, we can start building
For Version 1.3
make iso
For Version 1.4
./build-vyos-image iso --architecture amd64 --build-by "rod@rod.ac"
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.