No description
This repository has been archived on 2026-11-17. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
  • Shell 37.7%
  • Python 33.9%
  • Groovy 16%
  • Dockerfile 8.9%
  • Go 2.5%
  • Other 1%
Find a file
2024-03-09 21:14:26 +00:00
.github GitHub: add labeler.yml 2024-03-03 08:33:31 +01:00
data add chrony and fuse-overlayfs 2024-03-09 15:55:44 +00:00
docker docker: T4440: add OCI container labels 2024-02-27 17:37:03 +00:00
docker-vyos docker: T4440: add OCI container labels 2024-02-27 17:37:03 +00:00
packages add kernel config from #288 2024-03-09 21:14:26 +00:00
scripts apply changes to cmdline 2024-03-09 15:57:55 +00:00
tools ci/cd: update branch references current -> sagitta 2023-09-25 20:36:56 +02:00
vars ci/cd: update branch references current -> sagitta 2023-09-25 20:36:56 +02:00
.gitignore Makefile: T2640: add helper to convert ISO to OCI image to start a container 2023-11-27 08:46:58 +01:00
build-vyos-image T3664: initial implementation of the build flavor system 2022-10-06 17:55:01 -04:00
CONTRIBUTING.md T5001: Replace links to the phabricator site 2023-02-12 21:13:05 +01:00
Jenkinsfile Jenkins: fix invalid base version when building ISO with custom version string 2023-12-21 20:05:13 +01:00
Jenkinsfile.docker ci/cd: update branch references current -> sagitta 2023-09-25 20:36:56 +02:00
LICENSE Import the license. 2015-12-17 01:25:03 -05:00
LICENSE.artwork Add a file with artwork license and modified image distribution guidelines 2021-11-06 18:16:18 +07:00
Makefile Makefile: add new target qemu-live 2023-11-27 08:48:02 +01:00
README.md Update documentation links and remove references to Vyatta 2023-08-04 17:44:19 +01:00

VyOS toplevel build

For the most up-to-date documentation, please read the online build guide at docs.vyos.io.

What is VyOS

VyOS is an open source operating system for network devices (routers, firewalls and so on). If you want to use it in your network, check out download and installation instructions at https://docs.vyos.io/en/latest/installation/index.html

If you want to modify VyOS and/or join its development, read on.

About this repository

VyOS is a GNU/Linux distribution based on Debian. Just like any other distribution, it consists of multiple packages.

Some packages are taken from the upstream, while other are modified or written from scratch by VyOS developers. Every package maintained by the VyOS team has its own git repository. VyOS image build is therefore a multi-step process. Packages are compiled first, then an ISO is built from Debian packages and our own packages.

This is the top level repository that contains links to repositories with VyOS specific packages (organized as Git submodules) and scripts and data that are used for building those packages and the installation image.

Repository Structure

There are several directories with their own purpose:

  • build/ Used for temporary files used for the build and for build artifacts
  • data/ Data required for building the ISO (e.g. boot splash/configs)
  • packages/ This directory has two meanings. First it can hold arbitrary *.deb packages which will be embeded into the resulting ISO, but it also holds Jenkins Pipeline definitions for required VyOS packages. Among other things those packages will be: Linux Kernel, FRR, Netfiler...
  • scripts/ Scripts that are used for the build process
  • tools/ Scripts that are used for maintainer's tasks automation and other purposes, but not during ISO build process
  • vars/ Jenkins Pipeline library for reusable functions

Building VyOS

In order to have a single manual and not maintining multiple copies the instructions on how to build VyOS either in a Docker container or natively can be found in our Documentation - Build VyOS.

Development Branches

The default branch that contains the most recent VyOS code is called current rather than master. We know it's confusing, but it's not easy to fix. In a nutshell, the code we inherited from Vyatta Core had its master branch so out of sync with everything it was beyond any repair. Vyatta developers used to create a new branch not when a release is ready for code freeze, but rather before starting to work on a new release. This is hard to change in existing code, so this is just the way it is, for now.

All new code goes to the current branch. When it's time for a code freeze, a new branch is created for the release, and new code from current is backported to the release branch as needed.

In packages that originate from VyOS the master branch is kept in sync with current, but we still use current as default branch for uniformity. When the last legacy package is gone, we will switch to using the master branch and retire current.

Post-1.2.0 branches are named after constellations sorted by area from smallest to largest. There are 88 of them, here's the complete list.

  • VyOS 1.2: crux (Southern Cross)
  • VyOS 1.3: equuleus (Little Horse)
  • VyOS 1.4: sagitta (Arrow)
  • ...