cmd service - nself-org/cli GitHub Wiki
Enable, disable, and list optional ɳSelf services.
nself service <subcommand> [flags]
nself service manages the optional services in your ɳSelf stack. The four core services (PostgreSQL, Hasura, Auth, Nginx) are always included. The six optional services, Redis, MinIO, Email, Functions, Search, and Admin, are controlled through this command.
Enabling or disabling a service writes to your .env file. After changing service state, run nself build to regenerate docker-compose.yml with the updated service set, then nself restart to apply the changes.
MLflow is no longer an optional service. Use nself plugin install mlflow instead.
| Subcommand | Description |
|---|---|
enable <name> |
Enable an optional service |
disable <name> |
Disable an optional service |
list |
List all optional services with enabled/disabled status |
upgrade <name> <version> |
Pin a service to a specific image version |
configure <service> |
Configure a service (e.g. email provider presets) |
| Service | Env Var | Aliases |
|---|---|---|
redis |
REDIS_ENABLED |
— |
minio |
MINIO_ENABLED |
storage |
email |
MAILPIT_ENABLED |
mail, mailpit
|
functions |
FUNCTIONS_ENABLED |
— |
search |
SEARCH_ENABLED |
meilisearch |
monitoring |
MONITORING_ENABLED |
— |
admin |
NSELF_ADMIN_ENABLED |
— |
| Flag | Default | Description |
|---|---|---|
--env |
current | Target environment file |
--json |
false | Output as JSON array (for list) |
--help, -h
|
— | Show help |
# List all optional services
nself service list
nself service list --json
# Enable Redis
nself service enable redis
# Enable MinIO object storage (using alias)
nself service enable storage
# Enable monitoring stack
nself service enable monitoring
# Enable monitoring for production environment
nself service enable monitoring --env prod
# Disable Mailpit
nself service disable mailpit
# Disable MeiliSearch (using alias)
nself service disable meilisearch
# After changing services, rebuild and restart
nself build && nself restart