opschain admin licence show

Included from Basic tier

Shows the server's stored licence, read from /api/info — the only licence read the API serves. Against a current server the resolved licence_status renders in full: tier, expiry state, grace days, an explicit renewal line once the effective licence is inside its grace horizon, the effective limits (projects, environments, assets, runners, agents, runner groups — unlimited where unbounded), the granted features, and every stored document with its own tier, expiry, state and licensee — a stored document that no longer contributes names the winning document that supersedes it. For every enforcement: online document an online verification: block follows, showing the licence service, installation id, verify cadence, last outcome, when it last verified and when the next check is due (the same block opschain admin licence verify reports). Warnings follow for granted feature names outside this build's vocabulary (inert), documents that failed signature re-verification, and documents revoked by LimePoint.

The renewal line is the command's point: due once expiry is within the grace-days horizon, REQUIRED inside the grace window (with the time left until the server stops accepting new work), OVERDUE once the window has ended — each naming opschain admin licence apply as the remedy. The Basic tier never expires and shows no renewal line.

Against an older server without licence_status, the raw licence_info block prints instead; with no licence at all the command prints no licence is installed on this server, and a stored-but-invalid licence prints a line telling you to re-apply a valid one.

The verb authenticates as the ordinary logged-in user and requires a server target (--server <url>, OPSCHAIN_SERVER, or the active context); -o json|yaml prints the raw licence and status blocks.

Exit codes

Code	Meaning
0	Licence (or its absence) reported.
1	The request failed or the info document could not be decoded.
2	Usage error — no server target.

Named errors

• the licence lives on a server — pass --server <url> or 'opschain context use <name>' — no server target (exit 2).

Examples

opschain admin licence show
tier:        enterprise
state:       ok
grace days:  14
limits:      projects=unlimited environments=unlimited assets=unlimited runners=50 agents=50 runner_groups=unlimited
features:    packs:oracle, ha
documents:
  acme-2027.licence                      enterprise  expires 2027-06-30             active    contributing  Acme Corp
  acme-2026.licence                      enterprise  expires 2026-06-30             expired   -             Acme Corp (superseded by acme-2027.licence)
online verification:
  installation inst-7f3a (licence acme-2027.licence) via https://licensing.limepoint.com, every 24h0m0s: ok, last verified 2026-10-29T03:12:44Z, next check 2026-10-30T03:20:01Z

See also

• opschain docs cli/admin-licence-apply — the remedy the renewal line names.
• opschain docs cli/admin-licence-features — what each granted feature gates.