nself tenant
nself tenant — ɳSelf documentation.
Tenant management: create, upgrade, suspend, destroy, audit.
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