System Image Management

The VyOS image-based installation is implemented by creating a directory for each image on the storage device selected during the install process.

The directory structure of the boot device:


The image directory contains the system kernel, a compressed image of the root filesystem for the OS, and a directory for persistent storage, such as configuration.

On boot, the system will extract the OS image into memory and mount the appropriate live-rw sub-directories to provide persistent storage system configuration.

This process allows for a system to always boot to a known working state, as the OS image is fixed and non-persistent. It also allows for multiple releases of VyOS to be installed on the same storage device.

The image can be selected manually at boot if needed, but the system will otherwise boot the image configured to be the default.

The default boot image can be set using the set system image default-boot command in operational mode.

A list of available images can be shown using the show system image command in operational mode.

vyos@vyos:~$ show system image
The system currently has the following image(s) installed:

   1: 1.2.0-rolling+201810021347 (default boot)
   2: 1.2.0-rolling+201810021217
   3: 1.2.0-rolling+201809280337
   4: 1.2.0-rolling+201809252218
   5: 1.2.0-rolling+201809192034
   6: 1.2.0-rolling+201809191744
   7: 1.2.0-rolling+201809150337
   8: 1.2.0-rolling+201809141130
   9: 1.2.0-rolling+201809140949
  10: 1.2.0-rolling+201809131722


Images no longer needed can be removed using the delete system image command.

Update VyOS Installation

Finally, new system images can be added using the add system image command. The add image command will extract the image from the release ISO (either on the local filesystem or remotely if a URL is provided). The image install process will prompt you to use the current system configuration and SSH security keys, allowing for the new image to boot using the current configuration.

vyos@vyos:~$ add system image
Trying to fetch ISO file from
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  338M  100  338M    0     0  3837k      0  0:01:30  0:01:30 --:--:-- 3929k
ISO download succeeded.
Checking for digital signature file...
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
curl: (22) The requested URL returned error: 404 Not Found

Unable to fetch digital signature file.
Do you want to continue without signature check? (yes/no) [yes]
Checking MD5 checksums of files on the ISO image...OK.

What would you like to name this image? [1.2.0-rolling+201810030440]:

OK.  This image will be named: 1.2.0-rolling+201810030440
We do not have enough disk space to install this image!
We need 344880 KB, but we only have 17480 KB.


Rolling releases are not GPG signed, only the real release build will have a proper GPG signature.


VyOS configuration is associated to each image, and each image has a unique copy of its configuration. This is different than a traditional network router where the configuration is shared across all images.

If you need some files from a previous images - take a look inside a /live directory.

After reboot you might want to verify the version you are running with show version

vyos@vyos:~$ show version
Version:          VyOS 1.2.0-rolling+201810030440
Built by:
Built on:         Mon 10 Mar 2018 03:37 UTC
Build UUID:       2ed16684-875c-4a19-8a34-1b03099eed35
Build Commit ID:  3305dca496d814

Architecture:     x86_64
Boot via:         installed image
System type:      Microsoft Hyper-V guest

Hardware vendor:  Microsoft Corporation
Hardware model:   Virtual Machine
Hardware S/N:     9705-6585-6578-0429-1204-0427-62
Hardware UUID:    5260b1ce-4028-4d9c-bc5d-4f8425e5c056

Copyright:        VyOS maintainers and contributors