hart admin
Cluster administration: doctor, users, audit, licence
cmd/hart at v1.5.0These commands need the cluster admin role.
hart admin [flags]
hart admin [command]Subcommands:
hart admin audit: Show the audit log, newest firsthart admin doctor: Check the installation's healthhart admin license: Show the installation's licence, install one, or write the usage reporthart admin users: List every user of the installation
hart admin audit
Shows audit rows. --action takes an action (workspace.create) or an area prefix ending in a dot
(workspace.); --since and --until a duration back from now (24h) or a time (RFC 3339).
hart admin audit [flags]Examples:
hart admin audit --action api_key. --since 24h| Flag | Description |
|---|---|
--action string | an action or an area prefix ending in a dot |
--actor int | only rows of this user id |
--limit int | show at most this many rows (default 100) |
--of-team int | only rows of this team id |
--since string | only rows since this time or this long ago |
--until string | only rows until this time or this long ago |
hart admin doctor
Runs the checks core can make from its own state. The exit status is 1 when a check failed.
--capabilities adds what the cluster offers: the Kubernetes version, every optional feature with its state and,
for one that is not available, the reason, and the result of the NetworkPolicy self-check that helm test runs.
With -o json or -o yaml the output is then one document with the keys doctor and capabilities.
hart admin doctor [flags]| Flag | Description |
|---|---|
--capabilities | also show what the cluster offers: features, their states and the NetworkPolicy self-check |
hart admin license
Without a subcommand: the licence in force, its state, the limits against what they count now and their daily high of the last 90 days, and every licence installed so far. The exit status is 1 while the installation is restricted.
A licence state never stops anything that runs; restricted only refuses new teams, organizations, workspaces, managed services, domains, invitations and users.
hart admin license [flags]
hart admin license [command]Subcommands:
hart admin license install: Install a licencehart admin license usage-report: Write the usage report for the licence renewal
hart admin license install
Checks the licence offline and installs it; nothing is sent anywhere. A licence whose term starts later
takes over on its start date. -f - reads the licence from stdin.
hart admin license install [flags]Examples:
hart admin license install -f example-HL-2026-0001.license| Flag | Description |
|---|---|
-f, --file string | the licence file (- for stdin) |
hart admin license usage-report
Writes the daily highs of the counted limits since the start of the licence in force (at most a year) as JSON: counts only, no names or email addresses. Hand it over at renewal; the installation never sends it.
hart admin license usage-report [flags]Examples:
hart admin license usage-report --out usage.json| Flag | Description |
|---|---|
--out string | write the report to this file instead of stdout |
hart admin users
List every user of the installation
hart admin users [flags]| Flag | Description |
|---|---|
--limit int | show at most this many users (default 200) |
--q string | only users whose email or name contains this text |