controller - nself-org/cli GitHub Wiki
Manage the ɳCloud multi-tenant master controller.
The controller manages N isolated ɳSelf project instances on a single server. Each project gets its own Postgres schema, Hasura metadata source, Nginx virtual host, JWT secret, Redis key prefix, and MinIO bucket.
Requires: NSELF_FLAG_MULTI_TENANT_CONTROLLER=true
nself controller <subcommand>
| Subcommand | Description |
|---|---|
start |
Start the controller daemon |
stop |
Stop the controller daemon |
status |
Show all projects and resource usage |
Starts the controller daemon as a systemd service (nself-controller). On non-systemd systems, prints the command to run the binary directly.
nself controller start
Stops the controller daemon.
nself controller stop
Displays all projects with their resource usage: connection count, schema size, and health.
nself controller status
Output:
SLUG DOMAIN STATUS CONNS SIZE HEALTHY
myapp myapp.myserver.com active 2 1.2 MB true
clientb clientb.myserver.com active 0 512 KB true
2 / 50 projects active (4% utilized)
| Variable | Default | Description |
|---|---|---|
NSELF_FLAG_MULTI_TENANT_CONTROLLER |
false |
Enable multi-tenant controller |
NSELF_CONTROLLER_ADDR |
http://127.0.0.1:3750 |
Controller daemon address |
NSELF_CONTROLLER_ADMIN_TOKEN |
— | Admin authentication token (required) |
NSELF_CONTROLLER_HOST |
127.0.0.1 |
Daemon bind host |
NSELF_CONTROLLER_PORT |
3750 |
Daemon bind port |
-
nself project, Manage individual projects - Multi-Tenant Hosting Guide