summaryrefslogtreecommitdiff
path: root/docs/installation/virtual/md-libvirt.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/installation/virtual/md-libvirt.md')
-rw-r--r--docs/installation/virtual/md-libvirt.md186
1 files changed, 0 insertions, 186 deletions
diff --git a/docs/installation/virtual/md-libvirt.md b/docs/installation/virtual/md-libvirt.md
deleted file mode 100644
index 0a21a97a..00000000
--- a/docs/installation/virtual/md-libvirt.md
+++ /dev/null
@@ -1,186 +0,0 @@
----
-lastproofread: '2026-02-02'
----
-
-(libvirt)=
-
-# Run VyOS on Libvirt QEMU/KVM
-
-Libvirt is an open-source API, daemon, and management tool for managing platform
-virtualization. You can deploy VyOS on libvirt KVM in several ways:
-using Virt-Manager or the native CLI. This example uses 4 gigabytes
-of memory, 2 CPU cores, and the default network `virbr0`.
-
-## CLI
-
-### Deploy from ISO
-
-Create VM name `vyos_r1`. You must specify the path to the `ISO` image,
-the disk `qcow2` will be created automatically. The `default` network is
-the virtual network (type Virtio) created by the hypervisor with NAT.
-
-```none
-$ virt-install -n vyos_r1 \
- --ram 4096 \
- --vcpus 2 \
- --cdrom /var/lib/libvirt/images/vyos.iso \
- --os-variant debian10 \
- --network network=default \
- --graphics vnc \
- --hvm \
- --virt-type kvm \
- --disk path=/var/lib/libvirt/images/vyos_r1.qcow2,bus=virtio,size=8 \
- --noautoconsole
-```
-
-Connect to the VM with the command `virsh console vyos_r1`
-
-```none
-$ virsh console vyos_r1
-
-Connected to domain vyos_r1
-Escape character is ^]
-
-vyos login: vyos
-Password:
-
-vyos@vyos:~$ install image
-```
-
-After installation, exit the console using the key combination
-`Ctrl + ]` and reboot the system.
-
-### Deploy from qcow2
-
-The benefit of using {abbr}`KVM (Kernel-based Virtual Machine)`
-images is that they don't require installation.
-Download the predefined VyOS `.qcow2` image.
-
-```none
-curl --url link_to_vyos_kvm.qcow2 --output /var/lib/libvirt/images/vyos_kvm.qcow2
-```
-
-Create VM with `import` qcow2 disk option.
-
-```none
-$ virt-install -n vyos_r2 \
- --ram 4096 \
- --vcpus 2 \
- --os-variant debian10 \
- --network network=default \
- --graphics vnc \
- --hvm \
- --virt-type kvm \
- --disk path=/var/lib/libvirt/images/vyos_kvm.qcow2,bus=virtio \
- --import \
- --noautoconsole
-```
-
-Connect to the VM with the command `virsh console vyos_r2`
-
-```none
-$ virsh console vyos_r2
-
-Connected to domain vyos_r2
-Escape character is ^]
-
-vyos login: vyos
-Password:
-
-vyos@vyos:~$
-```
-
-If you cannot access the login screen, the KVM console may be set as the
-default boot option.
-
-Open a secondary session and run this command to reboot the VM:
-
-```none
-$ virsh reboot vyos_r2
-```
-
-Then go to the first session where you opened the console.
-Select `VyOS 1.4.x for QEMU (Serial console)` and press `Enter`.
-
-The system is fully operational.
-
-## Virt-Manager
-
-The Virt-Manager application is a desktop user interface for managing virtual
-machines through libvirt. On Linux, open the
-{abbr}`VMM (Virtual Machine Manager)`.
-
-(libvirt-virt-manager-iso)=
-
-### Deploy from ISO
-
-1. Open {abbr}`VMM (Virtual Machine Manager)` and create a new
- {abbr}`VM (Virtual Machine)`
-2. Choose `Local install media` (ISO)
-
-:::{figure} /_static/images/virt-libvirt-01.webp
-:::
-
-3. Choose the path to the VyOS ISO image. Select any Debian-based operating
- system.
-
-:::{figure} /_static/images/virt-libvirt-02.webp
-:::
-
-4. Choose Memory and CPU
-
-:::{figure} /_static/images/virt-libvirt-03.webp
-:::
-
-5. Disk size
-
-:::{figure} /_static/images/virt-libvirt-04.webp
-:::
-
-6. Name of VM and network selection
-
-:::{figure} /_static/images/virt-libvirt-05.webp
-:::
-
-7. Then the system will be taken to the console.
-
-:::{figure} /_static/images/virt-libvirt-06.webp
-:::
-
-(libvirt-virt-manager-qcow2)=
-
-### Deploy from qcow2
-
-Download the predefined VyOS `.qcow2` image.
-
-```none
-curl --url link_to_vyos_kvm.qcow2 --output /var/lib/libvirt/images/vyos_kvm.qcow2
-```
-
-1. Open {abbr}`VMM (Virtual Machine Manager)` and create a new
- {abbr}`VM (Virtual Machine)`
-2. Choose `Import existing disk` image
-
-:::{figure} /_static/images/virt-libvirt-qc-01.webp
-:::
-
-3. Choose the path to the `vyos_kvm.qcow2` image that you downloaded.
- Select any Debian-based operating system.
-
-:::{figure} /_static/images/virt-libvirt-qc-02.webp
-:::
-
-4. Choose Memory and CPU
-
-:::{figure} /_static/images/virt-libvirt-03.webp
-:::
-
-5. Name of VM and network selection
-
-:::{figure} /_static/images/virt-libvirt-05.webp
-:::
-
-6. Then the system will be taken to the console.
-
-:::{figure} /_static/images/virt-libvirt-qc-03.webp
-:::