Installation

Install VirtuaOS

VirtuaOS = Debian 13 + the kernel-virtua kernel + the Virtua platform. Allow a few minutes on a minimal Debian 13 server.

Requirements

ItemRequired
OSDebian 13 (Trixie), minimal install
Architecturex86_64 (amd64)
CPUVirtualization enabled in BIOS/UEFI (Intel VT-x or AMD-V) — check with kvm-ok
Memory2 GB minimum (more depending on your VMs)
Disk10 GB for the system and Virtua, plus space for your VMs
Accessroot / sudo, Internet access
Ports8441, 80, 443, 3389/tcp (opened by the installer)

Recommended method

Install from the APT repository

  1. 1

    Add the APT source

    The signing key is embedded in the virtua.sources file:

    sudo curl -fsSL https://dep.auxinux.ca/VIRTUA/virtua.sources \
      -o /etc/apt/sources.list.d/virtua.sources
  2. 2

    Install Virtua

    sudo apt update
    sudo apt install auxinux-virtua

    Follow the provisioning:

    journalctl -fu auxinux-virtua-setup
  3. 3

    Add the VirtuaOS kernel (recommended)

    sudo apt install kernel-virtua
    sudo reboot

    The kernel source is declared separately: see the Kernel page.

  4. 4

    Sign in

    Open https://<SERVER-IP> (or http://<SERVER-IP>:8441). Initial credentials: admin / admin123 — changing the password is mandatory on first login.

ISO image

VirtuaOS ISO image (beta)

A beta installation image is also published. The APT method above remains recommended: it always installs the latest Virtua version.

VirtuaOS 1.0.3-BETA — amd64

Beta ISO image.

  • File: VirtuaOS-1.0.3-BETA-amd64.iso
  • Size: 1.36 GB
  • Released August 26, 2026
Download the ISO

All images

Directory of published images.

Browse

Maintenance

Update, repair, uninstall

Update — the package automatically re-runs the Virtua update:

sudo apt update && sudo apt upgrade

Uninstall — your VMs, LXC and Docker containers are never touched:

sudo apt remove auxinux-virtua   # keeps data
sudo apt purge auxinux-virtua    # removes /var/lib/auxinuxvirtual

Install from source:

git clone https://git.auxinux.ca/Auxinux/Virtua.git /opt/auxinuxvirtual
cd /opt/auxinuxvirtual
sudo bash INSTALL/install.sh

install.sh options: -update (update, keep everything), -repair (reinstall the panel), -reset (wipe portal data), -clean (full reinstall). -reset and -clean keep pools, snapshots, images, templates and Compose files.