Docmost — an open-source collaborative wiki and documentation platform (spaces, pages, real-time editing) — a self-hosted Confluence/Notion alternative. Deployed all-in-one with PostgreSQL and Redis in a single host-networked Nomad job.
Save as values.hcl, edit, then run:
# The name of the Nomad job.
job_name = "docmost"
# The Nomad namespace to deploy into.
namespace = "default"
# The datacenters to deploy to.
datacenters = ["*"]
# The Docmost container image. Pin a tag in production.
image = "docmost/docmost:latest"
# Host port for the Docmost web app. Default 3007 to avoid other packs on 3000-3006.
port = 3007
# Secret key for sessions/tokens — at least 32 characters. CHANGE THIS (e.g. `openssl rand -hex 32`) and keep it stable.
app_secret = "CHANGE_ME_docmost_app_secret_min_32_characters_long"
# Public URL Docmost is served at (e.g. https://docs.example.com), used for links/email. Empty = leave unset (uses request host).
app_url = ""
# Resources for the Docmost task.
docmost_resources = {
cpu = 500
memory = 512
}
# PostgreSQL image backing Docmost.
postgres_image = "postgres:16-alpine"
# Host port PostgreSQL listens on. Docmost connects on 127.0.0.1.
db_port = 5432
# Password for the Docmost Postgres user. CHANGE THIS. (DB name and user are both "docmost".)
db_password = "docmost"
# Docker named volume for the Postgres data dir (pages, spaces, users). Back it up.
db_data_volume = "docmost_db_data"
# Redis image (used for queues/websockets; ephemeral, no volume).
redis_image = "redis:7-alpine"
# Host port Redis listens on.
redis_port = 6379
# Docker named volume for /app/data/storage (uploaded attachments/images). A prestart task chowns it to uid 1000. Back it up.
storage_volume = "docmost_storage"
# Resources for the PostgreSQL task.
postgres_resources = {
cpu = 500
memory = 512
}
# Placement constraints — pin the job to one node so the local volumes stay put. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []
| Name | Type | Default | Description |
|---|---|---|---|
| job_name | string | "docmost" | The name of the Nomad job. |
| namespace | string | "default" | The Nomad namespace to deploy into. |
| datacenters | list | ["*"] | The datacenters to deploy to. |
| image | string | "docmost/docmost:latest" | The Docmost container image. Pin a tag in production. |
| port | number | 3007 | Host port for the Docmost web app. Default 3007 to avoid other packs on 3000-3006. |
| app_secret set me | string | "CHANGE_ME_docmost_app_secret_min_32_characters_long" | Secret key for sessions/tokens — at least 32 characters. CHANGE THIS (e.g. `openssl rand -hex 32`) and keep it stable. |
| app_url | string | "" | Public URL Docmost is served at (e.g. https://docs.example.com), used for links/email. Empty = leave unset (uses request host). |
| docmost_resources | object | {
cpu = 500
memory = 512
} | Resources for the Docmost task. |
| postgres_image | string | "postgres:16-alpine" | PostgreSQL image backing Docmost. |
| db_port | number | 5432 | Host port PostgreSQL listens on. Docmost connects on 127.0.0.1. |
| db_password key | string | "docmost" | Password for the Docmost Postgres user. CHANGE THIS. (DB name and user are both "docmost".) |
| db_data_volume | string | "docmost_db_data" | Docker named volume for the Postgres data dir (pages, spaces, users). Back it up. |
| redis_image | string | "redis:7-alpine" | Redis image (used for queues/websockets; ephemeral, no volume). |
| redis_port | number | 6379 | Host port Redis listens on. |
| storage_volume | string | "docmost_storage" | Docker named volume for /app/data/storage (uploaded attachments/images). A prestart task chowns it to uid 1000. Back it up. |
| postgres_resources | object | {
cpu = 500
memory = 512
} | Resources for the PostgreSQL task. |
| constraints | list | [] | Placement constraints — pin the job to one node so the local volumes stay put. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true". |
No variables match.
Docmost — an open-source collaborative wiki and documentation platform (spaces, nested pages, real-time editing, comments) — a self-hosted Confluence/Notion alternative. All-in-one: Docmost plus PostgreSQL and Redis in a single host-networked Nomad job.
nomad-pack registry add nomploy github.com/Nomploy/nomad-packs \
--var app_secret=$(openssl rand -hex 32)
nomad-pack run docmost --registry nomploy --var app_secret=$(openssl rand -hex 32)
In nomploy: create a Compose service, type Nomad Pack, pack docmost, set app_secret
(and app_url), then Deploy. Open http://<node-ip>:3007 and create the first workspace +
admin account.
| Variable | Default | Notes |
|---|---|---|
image |
docmost/docmost:latest |
Pin a tag in production. |
port |
3007 |
Web app. |
app_secret |
placeholder | ≥32 chars — change it (openssl rand -hex 32); keep it stable. |
app_url |
"" |
Public URL for links/email. |
db_password |
docmost |
Postgres password. Change this. |
db_data_volume |
docmost_db_data |
Pages/spaces/users. Back it up. |
storage_volume |
docmost_storage |
Uploaded attachments. Back it up. |
db_port / redis_port |
5432 / 6379 |
Bundled dependency ports. |
constraints |
[] |
Pin to a node so the volumes stay put. |
Per-task resources: docmost_resources, postgres_resources.
count is fixed to 1 (local Postgres + storage volumes). A prestart task
chowns the uploads volume to uid 1000. Pin with constraints.app_url. Email (invites) needs SMTP env
(MAIL_*) — add it if you want member email.