Docs and wikis, checked 2026-09-07
Docmost: Docker configuration reference
Self-hosted collaborative documentation and wiki platform with a realtime editor.
At a glance
- Image:
docker.io/docmost/docmost - Tags:
latest,0.95.0,0.95,0.90.1,0.90.0 - Licence: AGPL-3.0
- Source: https://github.com/docmost/docmost
- Docs: https://docmost.com/docs
Ports
| Port | What listens | Source |
|---|---|---|
3000 (docmost) | HTTP listener for the web app, API and websocket collaboration traffic. Route the reverse proxy here. | source for port 3000 |
Environment variables
| Variable | Required | What it does | Example | Source |
|---|---|---|---|---|
APP_URL | Yes | The public domain Docmost is served on. Used to build absolute links and share URLs. | https://docs.example.com | source for APP_URL |
APP_SECRET | Yes | Minimum 32 character secret used to sign sessions. Generate a unique value per installation. | openssl rand -hex 32 | source for APP_SECRET |
DATABASE_URL | Yes | Connection string for the Postgres database, including credentials and database name. | postgresql://docmost:password@db:5432/docmost | source for DATABASE_URL |
REDIS_URL | Yes | Connection string for Redis, used for queues and realtime collaboration state. | redis://redis:6379 | source for REDIS_URL |
STORAGE_DRIVER | No | Chooses where uploaded files live: local, s3 (any S3-compatible provider) or azure. | s3 | source for STORAGE_DRIVER |
Volumes that must persist
| Path | What is in it | Source |
|---|---|---|
/app/data/storage (docmost) | Local file storage for uploads when STORAGE_DRIVER is local. Not used once S3 or Azure storage is configured. | source for /app/data/storage |
/var/lib/postgresql (db) | Postgres data directory holding every workspace, page and space. The core data to back up. | source for /var/lib/postgresql |
/data (redis) | Redis append-only file, since the compose file runs Redis with appendonly enabled rather than as a pure cache. | source for /data |
Behind a reverse proxy
- The realtime collaborative editor depends on WebSockets; forward the Upgrade and Connection headers or the editor falls back to read-only. source for this reverse-proxy note
- APP_URL must match the domain the proxy serves Docmost on, since it is used to build absolute links. source for this reverse-proxy note
What it needs alongside it
| Dependency | Why | Source |
|---|---|---|
| PostgreSQL 18 | Primary database for workspaces, spaces and pages, addressed through DATABASE_URL. | source for PostgreSQL 18 |
| Redis 8 | Backs background jobs and the realtime collaboration layer, addressed through REDIS_URL. | source for Redis 8 |
Release timeline
| Version | Date | Breaking | What changed | Source |
|---|---|---|---|---|
v0.95.0 | 2026-07-03 | No | Adds a workspace default edit preference, a /time slash command, and translation-aware editor search. | source for release v0.95.0 |
v0.90.1 | 2026-05-28 | No | Bug fixes and security fixes. | source for release v0.90.1 |
v0.90.0 | 2026-05-21 | No | Adds page labels, synced blocks, indents, table sorting, backlinks and Azure Blob Storage support. | source for release v0.90.0 |
v0.80.2 | 2026-05-02 | No | Fixes an AWS_S3_FORCE_PATH_STYLE bug that broke file reads for installations using S3-compatible storage. | source for release v0.80.2 |
v0.80.0 | 2026-04-14 | No | Adds favorites, watch spaces and new security advisories are published alongside this release. | source for release v0.80.0 |
If it is not coming up
- WebSocket connection to 'wss://<your-domain>:6001/app/...' failed (UI shows "WARNING: Cannot connect to real-time service")
- 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-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.