Running on Proxmox

Proxmox is an open-source platform for virtualization. Visit https://vyos.io to download a .qcow2 image that you can import into Proxmox.

Deploy VyOS from CLI with qcow2 image

  1. Copy the .qcow2 image to a temporary directory on the Proxmox server.

  2. The commands assume virtual machine ID 200 is unused and you want the disk stored in a storage pool named local-lvm.

$ qm create 200 --name vyos2 --memory 2048 --net0 virtio,bridge=vmbr0
$ qm importdisk 200 /path/to/image/vyos-1.2.8-proxmox-2G.qcow2 local-lvm
$ qm set 200 --virtio0 local-lvm:vm-200-disk-0
$ qm set 200 --boot order=virtio0

  1. You can optionally attach a CDROM with an ISO as a cloud-init data source. The command assumes the ISO is uploaded to the local storage pool as seed.iso.

$ qm set 200 --ide2 media=cdrom,file=local:iso/seed.iso

  1. Start the virtual machine using the Proxmox GUI or run qm start 200.

Deploy VyOS from CLI with rolling release ISO

  1. Download the rolling release ISO from https://vyos.net/get/nightly-builds/. Non-subscribers can use the LTS release by building from source. For instructions, see the Build VyOS section. The VyOS source code repository is available at https://github.com/vyos/vyos-build.

  2. Prepare the VM for ISO installation. The commands assume your ISO is in storage pool ‘local’, you want VM ID ‘200’, and you want to create a new 15GB disk on storage pool ‘local-lvm’.

qm create 200 --name vyos --memory 2048 --net0 virtio,bridge=vmbr0 --ide2 media=cdrom,file=local:iso/live-image-amd64.hybrid.iso --virtio0 local-lvm:15

  1. Start the VM using qm start 200 or the start button in the Proxmox GUI.

  2. Open the virtual console for your VM using the Proxmox web GUI. Login username and password are both vyos.

  3. Once booted into the live system, type install image and follow the prompts to install VyOS to the virtual drive.

  4. After installation completes, remove the installation ISO using the GUI or run qm set 200 --ide2 none.

  5. Reboot the virtual machine using the GUI or run qm reboot 200.

For more information about downloading and installing Proxmox, visit https://www.proxmox.com/en/.