Skip to content

QEMU VMs

Run Bazzite AI OS as a QEMU virtual machine with cloud-init configuration.

Quick Start

Step Command Description Recording
1 ujust vm download Download QCOW2 image
2 ujust vm add Create and configure VM
3 ujust vm start Start the VM
4 ujust vm status Check VM status

Download QCOW2 Image

Pre-built QCOW2 images are available from CDN:

Command Description Recording
ujust vm download Download stable (default)
ujust vm download testing Download testing branch

Available branches:

  • stable - Main branch releases (recommended)
  • testing - Testing branch with latest features

Create and Run VM

Command Description Recording
ujust vm add Add VM with defaults
ujust vm start Start the VM
ujust vm ssh Connect via SSH
ujust vm vnc Connect via VNC
ujust vm status Show VM status
ujust vm stop Stop the VM

VM Management

Command Description Recording
ujust vm seed Regenerate cloud-init
ujust vm recreate Recreate VM config
ujust vm delete Delete VM
ujust vm boot-log Get boot messages
ujust vm diag Full diagnostics

Cloud-Init Parameters

When using ujust vm, these parameters can be customized:

Parameter Default Description
USERNAME $USER VM user account name
PASSWORD (none) Optional password for user
AUTOLOGIN true Enable automatic desktop login
SSH_PORT 2222 Host port forwarded to VM SSH
VNC_PORT 5900 Host port for VNC display
CPUS 4 Number of CPU cores
RAM 8192 Memory in MB
DISK_SIZE 100G Virtual disk size

Example with custom parameters:

ujust vm add my-vm CPUS=8 RAM=16384 SSH_PORT=2223

See Also