Skip to content

Manage your license

VirtConsole is licensed per management server. One license key covers one panel installation. On top of that, the license carries hypervisor addons in four tiers. Each connected hypervisor consumes one addon, and the tier sets how many instances that host may run.

You activate the license once after installation, and come back here when you buy more capacity.

Tier Limit per hypervisor
Unlimited Instances No per-host cap.
10 Instances / HV Up to 10 instances on this host.
5 Instances / HV Up to 5 instances on this host.
1 Instance / HV A single instance. Useful for dedicated-server style products.

The tiers are per host, not global. A license with 20 unlimited addons and 10 single-instance addons lets you connect 20 hypervisors with no cap and 10 hypervisors capped at one instance each.

In the admin panel go to System > License.

The License page opens on a status banner (License Active when you are within your limits), a License details card and a Usage against limits card.

License page

  1. Copy the license key from your VirtConsole account.
  2. Scroll to Activate or replace license and paste it into the License key field.
  3. Click Activate license. The page reloads and the banner at the top confirms the new state.

The new limits take effect immediately. To upgrade later, buy more addons in your account portal, then paste the updated key here and activate again. There is no downtime.

  • License details: the active Key, Expires date and the Licensed IP the key is bound to. The key is locked to the public IP of your management server; overall compliance is shown by the banner above the card, not by a separate status field.
  • Usage against limits: one row per tier (Unlimited Instances, 1 Instance / HV, 5 Instances / HV, 10 Instances / HV), each with a progress bar of in-use vs allowed hypervisor slots for that tier.

Each connected hypervisor needs a tier. You set it from the hypervisors list, not from the License page.

  1. Go to Infrastructure > Hypervisors.
  2. Find the hypervisor and look at the Licensing column.
  3. Click the tier button: infinity (unlimited), 1, 5 or 10. The active tier is highlighted.

The panel refuses to deploy new instances on a host that is over its tier limit.

With an active license you can connect hypervisors. The Usage against limits rows fill in as you assign tiers. If you ever exceed the licensed limits, the page switches to a conflict state that names the exceeded limits, and full admin access is restricted until you resolve them: either assign a different tier to a host, remove a hypervisor, or upgrade the license.

  • The page shows a license conflict. You are over a limit. Read the listed reasons, then open Infrastructure > Hypervisors and lower a host’s tier or remove it, or activate a key with more addons.
  • A key is refused on activation. Keys are bound to one management server IP. Check that the Licensed IP matches this server’s public IP, and that you copied the full key.
  • You cannot connect a new hypervisor. Every hypervisor consumes one addon slot. Buy another addon, or free a slot by removing an unused hypervisor.