Nomploy Nomad Packs

← All packs

docmost v0.1.0

Apps

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.

nomad-pack run docmost --registry nomploy
4 tasks http 3007db 5432redis 6379 2 volumes image docmost/docmost:latest
Variables 17
values.hcl

Save as values.hcl, edit, then run:

nomad-pack run docmost -f values.hcl --registry nomploy
# 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 = []
NameTypeDefaultDescription
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".
Readme

docmost

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.

Usage

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.

Key variables

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.

Notes