Toggle optional services on and off. The four required services (Postgres, Hasura, Auth, Nginx) are always on. Everything else is optional — enable only what your stack needs.
# See which optional services are on
nself service list
# Enable object storage
nself service enable storage
# Disable the local Admin UI (e.g. before a production deploy)
nself service disable adminnself service list
nself service enable <NAME>
nself service disable <NAME>nSelf ships six optional services on top of the four required ones. Enabling a service updates your active environment file and regenerates the Docker Compose config the next time you run nself build or nself start. Disabling a service removes it from the generated config — its data volumes are preserved until you explicitly run nself reset.
Changes take effect on the next nself start or nself restart. Running services are not interrupted immediately.
List all optional services with their current enabled/disabled state and a brief description.
nself service list
# NAME STATUS DESCRIPTION
# admin enabled Local Admin UI (localhost:3021)
# storage enabled S3-compatible object storage (MinIO)
# redis enabled Cache, sessions, and queues
# functions disabled Serverless function runtime
# mail enabled Transactional email (Mailpit in dev)
# search disabled Full-text search (MeiliSearch)| Flag | Type | Default | Description |
|---|---|---|---|
--format | string | text | Output format: text or json |
Enable an optional service. The service will start on the next nself start.
nself service enable search
nself service enable functions
nself service enable mailDisable an optional service. Data volumes are preserved — the service is simply removed from the generated compose config.
nself service disable search
nself service disable admin| Name | What it provides | Default | Port |
|---|---|---|---|
admin | nSelf Admin local web UI (nself/nself-admin Docker image) | enabled | 3021 |
storage | S3-compatible object storage (MinIO) | enabled | 9000 |
redis | Cache, session store, and background queues | enabled | 6379 |
functions | Serverless function runtime | disabled | — |
mail | Transactional email (Mailpit in dev, pluggable in prod) | enabled | 1025 / 8025 |
search | Full-text search via MeiliSearch | disabled | 7700 |
These four services cannot be disabled. They form the nSelf core stack.
| Service | Role |
|---|---|
| PostgreSQL | Primary database |
| Hasura | GraphQL API layer |
| Auth | Authentication service |
| Nginx | Reverse proxy and SSL terminator |
# Enable search, then restart to apply
nself service enable search
nself restart
# Or start fresh
nself stop
nself start0 — success1 — unknown service name2 — invalid arguments