Skip to content

deputyOS on Proxmox VE

Run deputyOS as a Proxmox guest. KVM acceleration, Proxmox snapshots and backups, with deputyOS fleet management on top.

Setup time
~20 min
Difficulty
Moderate
Cost
free (your hardware)
Acceleration
KVM

If you already run Proxmox, this is the natural place to put deputyOS. It ships as a community template wrapping the qemu-x86_64 build, so it behaves like any other guest.

Creating the VM

Download the qcow2 from the picker with proxmox selected, then on the Proxmox host:

qm create 900 --name deputyos --memory 8192 --cores 4 --net0 virtio,bridge=vmbr0
qm importdisk 900 deputyos-x86_64-standard.qcow2 local-lvm
qm set 900 --scsihw virtio-scsi-pci --scsi0 local-lvm:vm-900-disk-0
qm set 900 --boot order=scsi0
qm set 900 --cpu host
qm start 900

--cpu host matters: without it the guest may not see virtualisation features and local inference gets much slower.

Finding the wizard

Check the guest’s address from the Proxmox console or your DHCP table, then open http://<ip>. mDNS usually works if the guest is bridged onto your LAN, so http://deputyos.local is worth trying first.

Snapshots and backups

Proxmox snapshots work normally and are the fastest safety net before an upgrade.

Worth understanding: deputyOS also does its own A/B slot updates with watchdog rollback. The two are complementary — A/B handles a bad update automatically, Proxmox snapshots handle everything else, including your own mistakes.

GPU passthrough

If the host has a spare GPU, passing it through transforms local inference. Requires IOMMU enabled in firmware, the GPU in its own IOMMU group, and the host not using the card. Proxmox documents this well.

Why bother, given Proxmox already manages VMs

Proxmox manages hypervisors and guests. It will tell you the VM is running; it will not tell you whether the assistant inside is healthy, which model it is calling, or what it spent yesterday. That is the layer deputyOS adds — see deputyOS vs Proxmox.

Search

Search index isn't built yet. Run npm run build to generate it (Pagefind writes to dist/pagefind/).