TempleOS VM
templeos-vm manages a TempleOS virtual machine running under QEMU. TempleOS requires legacy BIOS boot and real VGA emulation, so QEMU is used instead of bhyve. Connect via VNC for the full TempleOS experience. The VM auto-stops when you close the VNC viewer unless --keep-alive is passed.
Install
Section titled “Install”templeos-vm installInteractive setup: choose RAM, CPU cores, and disk size. TempleOS is lightweight — 512MB RAM and 2GB disk are generous defaults. The installer downloads the TempleOS ISO automatically if no path is provided. Connect via VNC to complete the TempleOS setup wizard:
vncviewer localhost:5901During installation, answer y to install onto hard drive and y to the VM question. After the copy finishes, stop and relaunch to boot from disk.
Commands
Section titled “Commands”| Command | Action |
|---|---|
templeos-vm install | First-time setup and configuration |
templeos-vm launch | Start VM and connect via VNC (stops on exit) |
templeos-vm launch -k | Start VM, keep running after VNC closes |
templeos-vm stop | Shut down the VM |
templeos-vm status | Show current VM state |
templeos-vm remove | Destroy VM and delete all data |
Requirements
Section titled “Requirements”Required packages installed by templeos-vm install: qemu, gum, tigervnc-viewer, socat.
VNC Connection
Section titled “VNC Connection”The VM exposes a VNC framebuffer on port 5901. templeos-vm launch starts the VM, auto-selects Drive C at the TempleOS boot loader, and connects vncviewer automatically.
App Launcher
Section titled “App Launcher”After install, TempleOS appears in the Fuzzel launcher (Super + Space) as a desktop entry.