Download

Get the right image for your endpoint or lab workflow

Beagle OS images are served from your own Proxmox host after setup. The control plane generates VM-specific artifacts and USB scripts directly from the host that owns the target VM.

Getting Started Proxmox setup guide

Image formats

Choose the image that matches how you want to test, install, or mass-provision endpoints.

ISO

ISO installer

Use when you want to boot a machine or VM into the installer and deploy Beagle OS onto local storage.

Best for bare-metal rollout
Carries the installer flow
Pairs with VM-specific preset data

IMG

IMG direct flash

Use when you want a direct-flash artifact for repeatable endpoint media creation without a separate installer session.

Useful for appliance-style deployments
Fastest path to a prepared medium
Keeps the same runtime model

QC

QCOW2 test image

Use to test the endpoint OS inside a VM before you touch physical hardware or before you validate a release.

Ideal for lab validation
Good for regression testing
Same Moonlight runtime path

Full Proxmox host setup

Clone the repository and run the host setup on the Proxmox node that should own the Beagle control plane.

Core setup command

git clone https://github.com/meinzeug/beagle-os.git
cd beagle-os
./scripts/setup-proxmox-host.sh

Optional variables

INSTALL_DIR=/opt/beagle
PVE_DCV_PROXY_SERVER_NAME=srv.example.net
PVE_DCV_PROXY_LISTEN_PORT=8443
BEAGLE_SITE_PORT=443

Read the full reference Follow the quick start

VM-specific USB installer flow

Beagle keeps provisioning VM-centric. You do not create a generic endpoint and later decide where it should connect.

Install the Beagle control plane on Proxmox.
Prepare the target VM with Sunshine using the guest helper script.
Open the VM in Proxmox and download the generated USB live or installer script for exactly that VM.
Write the USB stick. The script downloads the host-served image payload and embeds the VM profile automatically.
Boot the endpoint. Beagle OS comes up in runtime mode and connects to the assigned VM.

System requirements

Component	Requirement
Proxmox VE	7.x minimum, 8.x recommended
Endpoint memory	2 GB minimum, 4 GB recommended
Endpoint storage	8 GB USB minimum, 16 GB SSD recommended
Network	100 Mbit LAN minimum, Gigabit recommended
VM GPU	Any GPU, NVIDIA with NVENC recommended

Checksum verification

Artifacts are published by your own Proxmox host after setup. Verify checksums directly on the host before you distribute images.

cd ${INSTALL_DIR:-/opt/beagle}/dist
sha256sum beagle-os-installer-amd64.iso
sha256sum pve-thin-client-usb-bootstrap-latest.tar.gz

The generated USB scripts download the matching payload from the same host, so the checksum you verify is the checksum your endpoint media uses.