Environment Variables

Environment Variables

Authoritative inventory of every environment variable read by the ɳSelf ecosystem. Generated from SPORT F09 (.claude/docs/sport/F09-ENV-VAR-INVENTORY.md) which audits cli/internal/config/.env.example plus every os.Getenv call in the CLI Go source plus every plugin envVars field.

Counts (verified 2026-04-17)

• Core CLI bootstrap vars: 200+ (in CLI Go code)
• Free plugin manifest vars: 100+ (across 25 plugins)
• Pro plugin manifest vars: 600+ (across 62 plugins)

Group 1: Core CLI (project bootstrap)

These are the minimum vars every ɳSelf project sets in .env.

Var	Type	Required	Default	Description
PROJECT_NAME	string	yes	myproject	Project identifier (used in container names, paths)
BASE_DOMAIN	string	yes	local.nself.org	Root domain for nginx routing + SSL
ENV	string	yes	dev	Environment: dev / staging / prod
nself	string	no	(mirrors ENV)	Alt env selector
PROJECT_DOMAIN	string	no	(derived from BASE_DOMAIN)	Override project subdomain
PROJECT_DESCRIPTION	string	no	""	Project description (used in admin UI)
nself	string	no	info	CLI log verbosity
LOG_LEVEL	string	no	info	Service-level log verbosity
NO_COLOR	bool	no	unset	Disable ANSI colors in CLI output

Group 2: Required services (always-on)

Var	Service	Default	Description
POSTGRES_PASSWORD	PostgreSQL	(generated)	Postgres superuser password
POSTGRES_DB	PostgreSQL	${PROJECT_NAME}	Default database name
HASURA_GRAPHQL_ADMIN_SECRET	Hasura	(generated)	Hasura admin secret
HASURA_GRAPHQL_JWT_SECRET	Hasura	(generated)	JWT signing key
AUTH_SMTP_HOST, AUTH_SMTP_PORT, AUTH_SMTP_USER, AUTH_SMTP_PASS	Auth	(Mailpit dev)	SMTP for email verification
NGINX_HTTP_PORT, NGINX_SSL_PORT	Nginx	80 / 443	Public-facing ports

Group 3: Optional services (toggle via *_ENABLED)

Var	Service	Default
ADMIN_ENABLED	nself-admin	false
MINIO_ENABLED	MinIO	false
REDIS_ENABLED	Redis	false
FUNCTIONS_ENABLED	Functions	false
MAIL_ENABLED	Mail (Mailpit dev)	false
SEARCH_ENABLED	Search (MeiliSearch)	false

MLflow (MLFLOW_ENABLED) was removed as a built-in optional service in v1.1.0. Install it as a free plugin: nself plugin install mlflow.

Group 4: Custom Services (CS_1..CS_10)

Per slot:

CS_1_NAME=ping_api
CS_1_LANGUAGE=go
CS_1_PORT=8001
CS_1_DOMAIN=ping.nself.org

Up to 10 slots (CS_1 through CS_10). web/ uses CS_1 = ping_api (telemetry + license validation, port 8001).

Group 5: Licensing

Var	Description	Source
nself	Pro plugin license key (loaded via �P1� license set)	~/.nself/license/key
nself	Bypass online validation for offline development	env-only
nself	Owner key (vault.env) for nself.org backend	vault.env

Plugin envVars

Each plugin declares its required env vars in its plugin.json manifest. See SPORT F09 for the full per-plugin breakdown (200+ unique vars across 100 paid).

For a single plugin:

nself plugin info <name>

The CLI prints required + optional env vars, defaults, and validation rules.

Source

• SPORT: .claude/docs/sport/F09-ENV-VAR-INVENTORY.md
• CLI source: cli/internal/config/.env.example
• Plugin manifests: plugins/free/<name>/plugin.json, plugins-pro/paid/<name>/plugin.json