Core Services

Core Services

The services an nSelf stack is made of, generated from internal/compose/service_catalog.go. The same data backs nself service list --core, so the CLI and this page cannot disagree.

Required services

Present in every stack. There is no switch to turn these off: without all four, an nSelf backend cannot serve a request.

Service	Purpose	Version override	Default image
postgres	PostgreSQL database — the system of record for every nSelf stack	POSTGRES_VERSION	pgvector/pgvector:pg16
hasura	Hasura GraphQL engine — the only supported data access path for apps	HASURA_VERSION	hasura/graphql-engine:v2.44.0
auth	hasura-auth — issues the JWTs Hasura authorises against	AUTH_VERSION	nhost/hasura-auth:0.36.0
nginx	Reverse proxy and TLS termination for every published route	NGINX_VERSION	nginx:1.25-alpine

Optional services

Added to the stack only when their enabling variable is true.

Service	Purpose	Enable with	Version override	Default image
nself-admin	nSelf Admin web UI (localhost only; never deployed)	NSELF_ADMIN_ENABLED=true	NSELF_ADMIN_VERSION	nself/nself-admin:latest
functions	Serverless function runtime	FUNCTIONS_ENABLED=true	FUNCTIONS_VERSION	nhost/functions:latest
mailpit	Development SMTP catcher — captures outbound mail instead of sending it	MAILPIT_ENABLED=true	MAILPIT_VERSION	axllent/mailpit:v1.15
meilisearch	Full-text search index (SEARCH_ENGINE=meilisearch, the default)	SEARCH_ENABLED=true	MEILISEARCH_VERSION	getmeili/meilisearch:v1.6
minio	S3-compatible object storage	MINIO_ENABLED=true	MINIO_VERSION	quay.io/minio/minio:RELEASE.2024-01-16T16-07-38Z
typesense	Full-text search index (SEARCH_ENGINE=typesense alternative)	SEARCH_ENABLED=true	TYPESENSE_VERSION	typesense/typesense:0.25.2
redis	Cache and queue backend	REDIS_ENABLED=true	REDIS_VERSION	redis:7.2-alpine

Checking your own stack

nself service list --core

---

Home · Commands · Config-Optional-Services