Databases and search, checked 2026-09-07
NocoDB: Docker configuration reference
Self-hosted spreadsheet-style interface over an existing SQL database, with a REST/GraphQL API and automations.
At a glance
Ports
Ports| Port | What listens | Source |
|---|
8080 | HTTP listener for the UI and the API. Route the proxy here. | source for port 8080 |
Environment variables
Environment variables| Variable | Required | What it does | Example | Source |
|---|
NC_DB | Yes | Connection string for the external database backing NocoDB's own metadata. Without it, NocoDB falls back to an embedded SQLite file instead. | pg://db:5432?u=nocodb&p=nocodb&d=nocodb | source for NC_DB |
NC_AUTH_JWT_SECRET | No | Secret used to sign authentication JWTs. Set explicitly so sessions survive a redeploy instead of invalidating on restart. | a random UUID | source for NC_AUTH_JWT_SECRET |
NC_SITE_URL | No | Public URL NocoDB uses when generating links such as shared view and form URLs. | https://nocodb.example.com | source for NC_SITE_URL |
NC_REDIS_URL | No | Redis connection used for caching and background job coordination between the app and worker containers. | redis://redis:6379 | source for NC_REDIS_URL |
Volumes that must persist
Volumes| Path | What is in it | Source |
|---|
/usr/app/data | NocoDB's own application data, including the embedded SQLite metadata store when NC_DB is not set. | source for /usr/app/data |
Behind a reverse proxy
What it needs alongside it
Dependencies| Dependency | Why | Source |
|---|
| PostgreSQL and Redis | The documented quickstart pairs NocoDB with postgres:17.10 for metadata and redis:7 for caching and queues. | source for PostgreSQL and Redis |
Release timeline
If it is not coming up
Read from the upstream documentation, repository and container registry by Keita Emsden on 2026-09-07. Every row links the page it came from. Upstream changes without telling anyone, so check the source link before you rely on a value.
Other app references
All app references