From VyOS Wiki
Revision as of 02:30, 30 July 2017 by Xrobau (talk | contribs) (Remove strange spam, clean up wording.)
Jump to: navigation, search

Downloading Image

Stable Builds

You can use the automatic load balancer to download the VyOS image from one of the official mirrors. The current stable release is 1.1.7.

  • vyos-*-amd64.iso
This is the standard ISO, and should be used for most installations.
  • vyos-*-amd64-signed.ova
Vmware OVA file, for use with Vmware ESXi.
  • vyos-*-i586.iso
Warning: Deprecated. This is for older machines that do not support 64 bit instructions.

Nightly (Unstable) Builds

Nightly builds are available at the build server. The format of the file is vyos-999.YYYYMMDDHHMM-amd64.iso. 32 Bit builds are also available, but are not recommended.


Boot the target machine from that image. If you are using serial console, set your target machine serial port settings to 9600/8/N/1.

When the machine boots, you will see the ISOLINUX banner, with basic instructions. Simply push 'enter' to boot.

After the machine has booted, you will see the login prompt. Log in with the username vyos and the password vyos

Once you are logged in, use the command install image to initiate installation, and answer the few questions. When the installation is finished, reboot the machine (with reboot command).

Here is an example installation session:

ISOLINUX 4.02 debian-20101014  Copyright (C) 1994-2010 H. Peter Anvin et al

*                                                           *
* Welcome to VyOS, an open source network operating system! *
*                                                           *
* Version: 1.1.7 (Helium)                                   *
*                                                           *
* Default login:    vyos                                    *
* Default password: vyos                                    *
*                                                           *
* To start installation, login and use command:             *
*     install image                                         *


Welcome to VyOS - vyos ttyS0

vyos login: vyos
Password: vyos

Linux vyos 3.13.11-1-amd64-vyos #1 SMP Wed Aug 12 02:08:05 UTC 2015 x86_64
Welcome to VyOS.
This system is open-source software. The exact distribution terms for 
each module comprising the full system are described in the individual 
files in /usr/share/doc/*/copyright.
vyos@vyos:~$ install image
install image
Welcome to the VyOS install program.  This script
will walk you through the process of installing the
VyOS image to a local hard drive.
Would you like to continue? (Yes/No) [Yes]: 

Probing drives: OK
Looking for pre-existing RAID groups...none found.
The VyOS image will require a minimum 1000MB root.
Would you like me to try to partition a drive automatically
or would you rather partition it manually with parted?  If
you have already setup your partitions, you may skip this step

Partition (Auto/Parted/Skip) [Auto]: 

I found the following drives on your system:
 sda	8589MB

Install the image on? [sda]:

This will destroy all data on /dev/sda.
Continue? (Yes/No) [No]: Y

How big of a root partition should I create? (1000MB - 8589MB) [8589]MB: 

Creating filesystem on /dev/sda1: OK
Mounting /dev/sda1...
What would you like to name this image? [1.1.3]: 

OK.  This image will be named: 1.1.3
Copying squashfs image...
Copying kernel and initrd images...
I found the following configuration files:
Which one should I copy to sda? [/config/config.boot]: 

Copying /config/config.boot to sda.
Enter password for administrator account
Enter password for user 'vyos': '''Enter a password here.''' (Note, you will not see the password as you enter it)

Retype password for user 'vyos': '''Enter the same password here'''

I need to install the GRUB boot loader.
I found the following drives on your system:
 sda	8589MB

Which drive should GRUB modify the boot partition on? [sda]:

Setting up grub: OK