Skip to main content

What is Planeon

Planeon is a self-hosted VDI (virtual desktop infrastructure) and infrastructure orchestration platform built on top of your own Proxmox VE cluster. It gives you pools of ready-to-use virtual desktops, session brokering, and browser-based desktop access, without exposing Proxmox itself to end users and without your desktop data leaving your own infrastructure.

What Planeon does​

  • Desktop pools — define a template, a target capacity, and a naming pattern once. Planeon clones, customizes, and keeps a pool of desktops at the size you configured, automatically replacing failed VMs so the pool stays at its desired state.
  • Session brokering — when a user requests a desktop, Planeon assigns them a ready VM from their pool (the same VM on repeat visits for persistent pools) and tracks the session as the user connects, disconnects, and reconnects.
  • Browser-based desktop access — users open a full remote desktop directly in a browser tab, no client software to install, powered by an integrated Guacamole-based gateway.
  • Native RDP — for users who prefer a desktop client, Planeon generates ready-to-use RDP connection files, optionally routed through an RD Gateway for access from outside the LAN.
  • Single sign-on (OIDC) — users and administrators authenticate through your existing identity provider (Keycloak, Microsoft Entra ID, Okta, Authentik, or any standards-compliant OIDC issuer).
  • Role-based access control — fine-grained roles and permissions govern who can administer clusters, pools, sessions, and access; access to desktops themselves is granted separately, to end users and groups. See Access management.
  • Audit log — every administrative and user action is recorded in a durable, tamper-evident audit trail: who did what, to which resource, and with what result.
  • Dashboards and metrics — an operator dashboard summarizes pool health, session activity, job queues, and cluster status at a glance; Prometheus metrics and health endpoints are available for your own monitoring stack. See Observability.
  • Licensing editions — Planeon ships with a free edition that works fully offline, with no license server and no time limit, covering 1 Proxmox cluster, 1 organization, and 25 seats. Paid editions raise or remove these limits and add capabilities such as white-labeling and multi-organization support. See Licensing.

How it's deployed​

Planeon runs as a small set of control-plane services — an API, a background worker, a web console, and a desktop-access gateway — that you deploy once, alongside your existing Proxmox VE cluster. Planeon does not replace or modify Proxmox VE; it orchestrates it through the Proxmox API. Nothing runs inside your virtual desktops except the QEMU guest agent (the same agent Proxmox VE already uses for guest integration), which Planeon relies on for OS detection, hostname configuration, and health checks — no other agent or service is installed inside your desktops.

Next steps​

  • Requirements — what to prepare before installing Planeon.
  • Installation guides and the quickstart for building your first desktop pool follow in the next sections of Getting Started.