Tenant Controller - nself-org/plugins GitHub Wiki

Tenant Controller Plugin

Field Value
Licence Free (MIT)
Maturity implemented (maturity levels)
Version 1.2.6
Install nself plugin install tenant-controller
Requirements nSelf >=1.0.9

Multi-tenant master controller for nCloud.

Install

nself plugin install tenant-controller

No license key required.

Description

Multi-tenant master controller for nCloud. Manages N isolated nSelf project instances behind a single deploy: per-project Postgres schema, Hasura metadata namespace, Nginx vhost, JWT secret, Redis key prefix, and MinIO bucket. Enables 50 projects on one Hetzner CX21.

Category: infrastructure. Current version: 1.1.2.

Configuration

Env Var Default Description
DATABASE_URL (required) PostgreSQL connection string
NSELF_CONTROLLER_ADMIN_TOKEN (required) -
NSELF_CONTROLLER_BASE_DOMAIN (required) -
HASURA_GRAPHQL_ADMIN_SECRET (required) Hasura admin secret (for Hasura metadata registration)
HASURA_GRAPHQL_ENDPOINT (required) -
NSELF_CONTROLLER_ENABLED - -
NSELF_CONTROLLER_MAX_PROJECTS - -
NSELF_CONTROLLER_DB - -
NSELF_PROJECT_SCHEMA_PREFIX - -
NSELF_PROJECT_REDIS_PREFIX - -
NSELF_PROJECT_HASURA_PORT_START - -
NSELF_CONTROLLER_PORT 3750 -
NSELF_CONTROLLER_HOST - -
REDIS_URL - -
MINIO_ENDPOINT - -
MINIO_ACCESS_KEY - -
MINIO_SECRET_KEY - -
NGINX_CONF_PATH - -
NSELF_AUDIT_RETENTION_DAYS - -
OTEL_EXPORTER_OTLP_ENDPOINT - -
LOG_LEVEL - -

Ports

Port Purpose
3750 Tenant Controller service port

Database Schema

3 table(s) added to your Postgres database:

  • nself_controller.projects
  • nself_controller.project_audit_log
  • nself_controller.port_map

REST API

GET    /controller/status
GET    /health
GET    /projects
POST   /projects/create
DELETE /projects/{slug}
GET    /projects/{slug}/status

Examples

Health check

curl http://localhost:3750/health

Source

plugins/tenant-controller/

Manifest: plugins/tenant-controller/plugin.json

See Also

← Home →

nself | nself-plugins | Commands | Issues | Changelog | License

⚠️ **GitHub.com Fallback** ⚠️