Skip to content
vvcontrol
Product

One portal, two audiences, zero changes to your Proxmox nodes

vcontrol sits in front of a Proxmox VE cluster and speaks only to its documented REST API. Everything a client can do is scoped to the servers assigned to them; everything an admin can do spans the whole cluster.

Who it's for

Hosting providers (admins)

Create clients, attach existing Proxmox inventory or provision new resource pools, assign plans and quotas, and manage every server across every client from one dashboard.

Their clients

Sign in to a portal scoped to only the servers they rent — power actions, snapshots, backups, and firewall rules, with no visibility into your cluster beyond that.

Architecture

Three planes, one source of truth

See HOW-IT-WORKS.md in the repository for the full technical breakdown.

1

Portal plane

The Next.js web app and REST API clients and admins interact with. Never talks to Proxmox nodes directly on the data path for reads — it reads its own database, which is kept in sync.

2

Control plane

A BullMQ worker executes power, snapshot, and backup actions against the Proxmox VE REST API asynchronously, and reconciles portal state against live cluster inventory on a schedule.

3

Proxmox VE

Your existing cluster, unmodified. vcontrol authenticates with a scoped API token — no agent, no node-level install, no cluster configuration changes.

Console access

In-browser console access, without exposing Proxmox directly

A dedicated gateway service relays a scoped websocket connection to a server's Proxmox console, so a client never needs direct network access to your cluster to use it.

Console access is part of the platform design and requires a real Proxmox cluster to fully verify end to end — see the security and features pages for what has already been verified against live infrastructure.

vcontrol's own tenant model (clients, resource pools, quotas) is purpose-built for a hosting business — not adapted from a generic multi-tenant SaaS template.

Data model

Clients, resource pools, and quotas modeled around how hosting actually works

Every client maps to a real Proxmox resource pool. Quotas cap servers, vCPU, RAM, and storage per client, enforced at the moment a server is attached or a plan is assigned — not just displayed after the fact.

Give your clients a real self-service portal for their Proxmox servers

Talk to us about running vcontrol in front of your own Proxmox VE cluster.