Docs and wikis, checked 2026-10-17
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
- Image:
ghcr.io/requarks/wiki - Tags:
2,2.5,2.5.316,2.5.315,latest - Licence: AGPL-3.0
- Source: https://github.com/requarks/wiki-v2
- Docs: https://docs.requarks.io/
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
| 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 database Wiki.js connects to. | wiki | source for DB_NAME |
Volumes that must persist
| Path | What is in it | Source |
|---|---|---|
/wiki/data/content | Declared as a VOLUME in the official image Dockerfile. | source for /wiki/data/content |
Behind a reverse proxy
- Wiki.js requires a dedicated subdomain or domain; it cannot be served from a subfolder of another site. source for this reverse-proxy note
- Route the proxy to port 3000. Leave Wiki.js's own SSL_ACTIVE and Let's Encrypt settings off when TLS is already terminated at the proxy. source for this reverse-proxy note
What it needs alongside it
| Dependency | Why | Source |
|---|---|---|
| PostgreSQL 9.5 or newer | Recommended database engine. The PostgreSQL search module needs the pg_trgm extension to be available. | source for PostgreSQL 9.5 or newer |
Release timeline
| Version | Date | Breaking | What changed | Source |
|---|---|---|---|---|
v2.5.316 | 2026-10-02 | No | Adds an export utility for migrating to Wiki.js 3.x and fixes truncated v3 exports. 2.x releases now live in requarks/wiki-v2. | source for release v2.5.316 |
v2.5.315 | 2026-09-21 | No | Security fixes stopping manage:users users editing manage:system users, and user-provided v-slot content (GHSA-45cp-v5ph-2jhm, GHSA-98c8-px3r-68c6). | source for release v2.5.315 |
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
- ECONNREFUSED / ENOTFOUND / connection to server at "postgres" port 5432 failed
- Coolify volume data lost after redeploy / a new empty volume is created every deploy
Read from the upstream documentation, repository and container registry by Keita Emsden on 2026-10-17. Every row links the page it came from. Upstream changes without telling anyone, so check the source link before you rely on a value.