Install the Beagle control plane on Proxmox

Entry points

./scripts/setup-proxmox-host.sh
./scripts/install-proxmox-host.sh
./scripts/check-proxmox-host.sh
./scripts/configure-sunshine-guest.sh
./scripts/register-moonlight-client-on-sunshine.sh
./scripts/build-beagle-os.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

What setup installs

• Beagle control plane services on the Proxmox host
• Reverse proxy configuration for hosted artifact delivery and UI access
• Proxmox UI integration, including the Create Beagle VM workflow
• Artifact hosting for VM-specific USB scripts and endpoint images

Create Beagle VM workflow

The Proxmox UI extension adds a Create Beagle VM action next to Create VM. The workflow keeps Ubuntu Desktop with GNOME as the desktop-oriented default and aligns the VM with the Beagle provisioning model.

Update and uninstall

Update

Update by pulling the repository changes and rerunning the supported host setup path.

Uninstall

Remove the host integration from the same installation directory so the UI extension, reverse proxy, and hosted artifacts are removed together.

Health check

./scripts/check-proxmox-host.sh

Expected output should confirm that the host-side Beagle services, proxy integration, and artifact hosting path are healthy.