Skip to content

Install.md

Latest commit

 

History

History
55 lines (45 loc) · 1.58 KB

Install.md

File metadata and controls

55 lines (45 loc) · 1.58 KB
Raw

🛠️ Install

TESTED on: Ubuntu 22.04; Debian 12

🔧 Prerequisites:

  • Linux machine support virtualization with KVM
  • KVM, QEMU and libvirt installed
  • Ensure a default network interface is defined in libvirt, typically named "default."

🚀 INSTALLATION:

  1. First, ensure your system is up to date and install the required dependencies:
sudo apt update
sudo apt install qemu-kvm libvirt-daemon-system
  1. Check if your system supports virtualization: KVM requires Intel processor with Intel VT-x and Intel 64 extensions or an AMD processor with the AMD-V and the AMD64 extensions.
virt-host-validate
# Must pass all validation items to work as a KVM host
  1. Download latest VmChamp:
wget -qO- https://api.github.com/repos/mzwoelfer/VmChamp/releases/latest | grep "browser_download_url" | cut -d '"' -f 4 | wget -i - -O vmchamp
  1. Install VmChamp
# Make the file executable:
chmod +x vmchamp

# Move vmchamp to your PATH:
# Move to /usr/local/bin that's in your PATH.
# Or rootless install ~/.local/bin:
mkdir -p ~/.local/bin
mv vmchamp ~/.local/bin/

# Ensure ~/.local/bin is in your PATH by adding the following to your ~/.bashrc or ~/.zshrc:
export PATH="$PATH:$HOME/.local/bin"
  1. Run VmChamp
vmchamp # Displays help message

ISSUES WITH INSTALLATION:

If your default interface is not started (wubbl0rz#3) try:

# use sudo if your user is not in the libvirt group
virsh --connect qemu:///system net-start --network default
virsh --connect qemu:///system net-autostart default