Skip to content

Terminology

Term Meaning
Provider The connection to a virtualization platform: Proxmox VE or Native KVM.
Hypervisor A managed node created by importing a Proxmox node or enrolling a native agent.
Location A commercial region that groups hypervisors.
Plan The booked resources and limits for an instance (CPU, memory, disk, networking, storage tier, backups).
Image The OS template an instance is built from.
Instance A virtual machine (VPS).
Volume A persistent extra disk, either an instance data disk or a standalone account volume.
Snapshot A fast restore point coupled to the VM/provider. Not a backup.
Backup A durable recovery artifact, independent of the VM's storage.
Task A durable record of an asynchronous mutation.
Reservation A capacity hold (CPU/memory/storage/VMID/IP) created during provisioning.
Entitlement A cap on what a tenant may hold or request.
Add-on A resource-only extension to a plan (no billing).
Console gateway The dedicated WebSocket service that brokers VM consoles.
Agent The pterocloud-agent running on a Native KVM host.
Lease The signed, short-lived license token that gates the control layer.
Mutation lock An exclusive lock that prevents conflicting operations (rebuild, migration, restore, rescue, resize, HA).
UPID A Proxmox task identifier. Admin-only; never shown to customers.
VMID A provider guest identifier. Admin-only; never shown to customers.
Support id An opaque reference (PC-YYYYMMDD-XXXXXX) attached to an error.
Public code A stable error identifier (PC-XXX-###).

Statuses

Status Meaning
pending, scheduling, reserved, cloning, configuring, booting, verifying, running Provisioning/instance lifecycle.
stopped, suspended, failed, rollback_failed, deleted Other instance states.
queued, dispatched, running, completed, failed, cancelled, timed_out Task lifecycle.