Documentation

VirtuaOS reference

The commands, services and paths you need to know.

CLI

The virtua command

virtua status                       # platform status
virtua list                         # all resources
virtua gui                          # text UI (dialog)
virtua setlang EN                   # FR or EN language

virtua vm list|info|start|stop|autostart|console
virtua lxc list|info|start|stop|autostart|console
virtua docker list|info|start|stop|edit|exec
virtua docker compose ...           # Compose stacks
virtua docker volumes ...
virtua docker prune

sudo virtua admin list              # admin accounts
sudo virtua admin reset [user]
sudo virtua admin create

The vos command (VirtuaOS)

sudo vos vdm install          # install the Datacenter Manager
vos vdm status
sudo vos vdm update
sudo vos vdm movenode node2
sudo vos vdm uninstall
sudo vos vdm ha enable        # VDM high availability
vos vdm ha status
sudo vos vdm ha disable

virtuaos setup shows installation progress.

Services and paths

ItemValue
API service (non-root)auxinuxvirtual-api — port 8441
Runner service (root)auxinuxvirtual-runner — socket /run/auxinuxvirtual.sock
Provisioningauxinux-virtua-setup
Bridge repairvirtua-bridge-heal
VDMLXC auxinux-vdm, auxinux-vdm service, port 8440
Data/var/lib/auxinuxvirtual/
ISOs/var/lib/libvirt/images/isos/

Troubleshooting

Common issues

The panel does not respond

systemctl status auxinuxvirtual-runner auxinuxvirtual-api
journalctl -u auxinuxvirtual-api -n 100

Port 8441 is already in use

ss -tlnp | grep 8441

Then change AUXINUX_PORT in apps/api/.env.

Lost administrator password

sudo virtua admin reset admin

KVM unavailable — check that virtualization is enabled in BIOS/UEFI: kvm-ok.