Skip to main content

Building ISO

VyOS Source Documentation

The steps below can be used to setup the build environment, build the packages and kernel, and then ultimately the ISO.

Too many people were building ISO images and making them publicly available, so the VyOS team no longer provides direct access to the pre-built package repositories. You must compile them yourself.

Prerequisites

You need to have Docker CE installed. See documentation for process.

Setup build environment

You can use either the Dockerhub instructions or the Build from source instructions.

Start the build environment

Download the vyos-build code from GitHub using the proper command:

# For VyOS 1.2 (crux)
$ git clone -b crux --single-branch https://github.com/vyos/vyos-build

# For VyOS 1.3 (equuleus)
$ git clone -b equuleus --single-branch https://github.com/vyos/vyos-build

# For VyOS 1.4 (sagitta)
$ git clone -b sagitta --single-branch https://github.com/vyos/vyos-build

# For VyOS 1.5 (circinus,current)
$ git clone -b current --single-branch https://github.com/vyos/vyos-build

As non-root user, start the docker container using the proper command:

$ cd vyos-build

# For VyOS 1.2 (crux)
$ docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos/vyos-build:crux bash

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

# For VyOS 1.4 (sagitta)
$ docker run --rm -it --privileged -v $(pwd):/vyos -w /vyos vyos/vyos-build:sagitta bash

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

Build vyos-1x packages

cd packages

git clone -b sagitta https://github.com/vyos/vyos-1x

cd vyos-1x/

dpkg-buildpackage -uc -us -tc -b

cd ..

dir *.deb

cd ..

Build the kernel