Files
vantage-docs/docs/hq/licensing-and-entitlements.md
T
mrhid6 11b1936bb2 feat: documentation site
Docusaurus 3 docs-only site at docsite/, served statically by nginx under
/docs on the marketing host. Covers getting started (self-hosted install
through first server and first licence), the control plane, Vantage HQ,
a reference section and operations.

Wired into docker-compose.site.yml as docsite (3005:80) and into the
image build workflow, rebuilding on its own directory only. Never added
to the self-hosted compose file.
2026-07-28 15:46:33 +01:00

3.2 KiB
Raw Blame History

id, title, sidebar_label
id title sidebar_label
licensing-and-entitlements Licensing and entitlements Licensing and entitlements

A licence is a signed statement of what one instance may do. An entitlement is the configuration a licence is cut from.

Tiers

Three tiers, in both deployments. The allowances are identical across cloud and self-hosted — what differs is the term on offer, not what you get.

Free Professional Enterprise
Servers (base) 3 3 10
Monitors 3 unlimited unlimited
Secret groups 1 unlimited unlimited
Notification channels 1 unlimited unlimited
Audit retention 30 days 365 days unlimited
Support Community Email, 24×5 Email and phone, 24×7

The server count is metered: the base allowance comes with the tier, and you buy additional servers on top. That is why Professional shows a real number rather than "unlimited" — the number you actually have is the one in your entitlement.

Features

Two are per-instance toggles rather than tier bundles:

Feature What it enables
console The browser console
oidc Per-instance single sign-on

No tier includes them by default; you enable them on the instances that need them.

Entitlements: desired and granted

Each instance has one entitlement row holding two configurations:

Meaning
Desired What you last asked for
Granted What a payment has confirmed

Checkout is built from desired. A licence is only ever signed from granted. An abandoned checkout therefore leaves a desired that reached nothing and changed nothing.

Increases and reductions

An increase takes effect when payment confirms, and the entitlement is promoted desired → granted.

A reduction is scheduled rather than immediate: you keep what you paid for until the end of the term, and the portal shows the date it drops. The collapse happens at renewal.

What a licence carries

Instance UUID, deployment, tier, resolved limits, features, term and expiry — all signed.

Two properties follow from that:

  • A licence is bound to one instance UUID. Moving it takes a relink.
  • A licence is a snapshot. Editing a plan later never rewrites an issued licence, the same way editing a workflow step never rewrites a past run.

Verification is local. Your instance does not call HQ to check a licence, and signing happens only in HQ.

Expiry and grace

Expiry is padded with a grace period. Past that, the instance goes into degraded mode: it keeps running and keeps your data, but stops letting you do everything.

The way out is a current licence — renew or purchase, then paste it (self-hosted) or let it be written for you (cloud).

Server limits in practice

When you exceed your server allowance, enrolling another one is refused. The existing fleet is unaffected. Raise the allowance in the portal, or remove a server you are not using.

Legacy tiers

An older self_hosted tier is mapped forward to self-hosted Professional wherever it appears. Nothing needs doing about it.