Přeskočit na obsah
DOKUMENTACE
Supported

Virtual machines

Tato stránka zatím není přeložená, zobrazuje se anglická verze.

The vm image is a preinstalled UFLinux system for hypervisors. Unlike the ISO, it has no live session and no installer — you write it, boot it, and log in. It is the quickest way to run the desktop in a VM, and the smallest image to test with.

Board id vm
Hypervisors QEMU, KVM and others
Architecture x86_64 and aarch64
Kernel Alpine linux-virt
Boot UEFI + systemd-boot
Root filesystem XFS, label UFLINUX_ROOT
Size 5120 MiB uncompressed

It uses XFS rather than f2fs because a virtual disk has none of the SD-card constraints that f2fs exists to serve — and because it matches the filesystem of an installed ISO system.

The image is a raw GPT disk, so it can be used directly as a disk image:

Terminal window
zstd -d uflinux-0.1.0-vm-x86_64.img.zst
qemu-system-x86_64 \
-machine q35 -cpu max -smp 2 -m 2048 \
-drive if=pflash,format=raw,readonly=on,file=/usr/share/OVMF/OVMF_CODE.fd \
-drive format=raw,file=uflinux-0.1.0-vm-x86_64.img \
-netdev user,id=n0 -device virtio-net-pci,netdev=n0

The root partition grows to fill the virtual disk on first boot, so enlarging the image before booting gives you the extra space.

Log in as user / user — the same account every device image ships — and use sudo or doas with that password for administrative commands. The greeter is enabled, so the account can log in graphically.

The installed desktop is developed and accepted against 512 MiB of RAM, one display and no swap, so a small guest is realistic rather than marginal. Give it more if you want a comfortable browser session.

UEFI boot works, but these images do not provide enrolled UEFI Secure Boot signatures. Run the guest with Secure Boot disabled. APK and modloop signatures are separate mechanisms and are unaffected.

The vm image is built from the same signed packages as the ISOs, but it is a separate artifact and is not covered by the automated BIOS/UEFI boot tests that gate an ISO release. If you want the artifact that CI actually boots, install the x86_64 ISO — see Installation.

Derived from docs/device-images.md inUFlinux-project/uflinux3(b4f4817). Report documentation problems inUFlinux-project/docs.