nself tenant
nself tenant — ɳSelf documentation.
[PREVIEW] Tenant management: create, upgrade, suspend, destroy, audit. This command is not yet fully implemented for production paying-customer onboarding flows.
Synopsis
nself tenant <subcommand> [flags] <slug-or-tenant-id>
Description
nself tenant manages tenant lifecycle in multi-tenant ɳSelf deployments. Each tenant has a slug, a plan (basic, pro, elite, business, business-plus, enterprise), and an audit trail.
tenant create provisions a new tenant with a starting plan. tenant upgrade changes the plan in place. tenant suspend halts a tenant’s access while preserving data; a --reason is required so the audit trail explains why. tenant destroy is the hard-delete path and requires --confirm-name <slug> to proceed. tenant audit queries the per-tenant audit log, optionally filtered by --since time window and rendered as table or JSON.
Plans must match server-side validation. Pair this command with nself billing for usage and invoicing.
Subcommands
| Name |
Description |
create <slug> |
Create a new tenant |
upgrade <slug> |
Change a tenant’s plan |
suspend <slug> |
Suspend a tenant |
destroy <slug> |
Hard-delete a tenant (DESTRUCTIVE) |
audit <tenant-id> |
Query tenant audit log |
Flags
tenant create <slug>
| Flag |
Default |
Description |
--plan |
basic |
Tenant plan: basic, pro, elite, business, business-plus, enterprise |
tenant upgrade <slug>
| Flag |
Default |
Description |
--plan |
"" |
Target plan (required) |
tenant suspend <slug>
| Flag |
Default |
Description |
--reason |
"" |
Reason for suspension |
tenant destroy <slug>
| Flag |
Default |
Description |
--confirm-name |
"" |
Type the tenant slug to confirm destruction |
tenant audit <tenant-id>
| Flag |
Default |
Description |
--since |
"" |
Time window, e.g. 7d, 24h, 2w |
--format |
table |
Output format: table or json |
Examples
# Create a new tenant on the basic plan
nself tenant create acme-corp
# Create on the pro plan from the start
nself tenant create acme-corp --plan pro
# Upgrade to elite
nself tenant upgrade acme-corp --plan elite
# Suspend with an explicit reason
nself tenant suspend acme-corp --reason "non-payment 30d overdue"
# Destroy a tenant after explicit confirmation
nself tenant destroy acme-corp --confirm-name acme-corp
# Audit the last week
nself tenant audit acme-corp --since 7d
# Export audit log as JSON
nself tenant audit acme-corp --since 30d --format json
See Also