Docs and wikis, checked 2026-09-07
Wiki.js: Docker configuration reference
Self-hosted wiki engine built on Node.js with Git-backed page history and multiple database backends.
At a glance
Ports
Ports| Port | What listens | Source |
|---|
3000 | Default HTTP listener for the web UI and API. Route the reverse proxy here. | source for port 3000 |
3443 | HTTPS listener, only used if Wiki.js terminates TLS itself via SSL_ACTIVE or its own Let's Encrypt integration. | source for port 3443 |
Environment variables
Environment variables| Variable | Required | What it does | Example | Source |
|---|
DB_TYPE | Yes | Database engine to use: postgres, mysql, mariadb, mssql or sqlite. All database variables are required unless noted. | postgres | source for DB_TYPE |
DB_HOST | Yes | Hostname or IP of the database server. Not used for sqlite. | db | source for DB_HOST |
DB_USER | Yes | Username Wiki.js uses to connect to the database. | wikijs | source for DB_USER |
DB_PASS | Yes | Password for the database user. Can be replaced with DB_PASS_FILE to read from a mounted secret file. | wikijsrocks | source for DB_PASS |
DB_NAME | Yes | Name of the empty database Wiki.js should use. It expects to own this database exclusively. | wiki | source for DB_NAME |
Volumes that must persist
Volumes| Path | What is in it | Source |
|---|
/wiki/data/content | Declared as a volume in the official image; holds cached content and local user uploads. | source for /wiki/data/content |
Behind a reverse proxy
What it needs alongside it
Dependencies| Dependency | Why | Source |
|---|
| PostgreSQL 9.5 or newer | Recommended database engine; required if using the High-Availability feature for multiple replicas. | source for PostgreSQL 9.5 or newer |
Release timeline
Releases| Version | Date | Breaking | What changed | Source |
|---|
v2.5.314 | 2026-05-01 | No | Updates the arm Docker base image to Node 24 and fixes a Windows build missing a migration file. | source for release v2.5.314 |
v2.5.313 | 2026-04-27 | Yes | Security fix preventing user assignment to elevated groups; fixes group permission assignment logic (GHSA-cq3g-mwrg-v2rv). | source for release v2.5.313 |
v2.5.312 | 2026-02-12 | No | Maps OIDC and OAuth2 avatar claims to the user picture URL, and fixes embedded diagram theming. | source for release v2.5.312 |
v2.5.311 | 2026-01-08 | No | Stops DOMPurify from breaking draw.io diagrams and fixes breadcrumb locale prefix handling. | source for release v2.5.311 |
v2.5.310 | 2026-01-06 | No | Fixes breadcrumb path generation and switches to a promisified stream pipeline. | source for release v2.5.310 |
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