4lt/docker-compose-cookbooks
1
0
Fork 0
mirror of https://github.com/nickyeoman/docker-compose-cookbooks.git synced 2026-10-22 20:16:22 +00:00
Code Issues Packages Projects Releases Wiki Activity

docmost: promote from _dev, use internal network, document APP_SECRET and proxy setup

Browse Source 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
code
2026-10-21 17:58:47 +00:00
co-authored by Claude Opus 5.5
parent 665c27e7f4
commit f1f22788a5
3 changed files with 20 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docmost_dev/README.md → docmost/README.md
+14 -11
View File
@@ -14,9 +14,9 @@ Docmost is a collaborative wiki and documentation platform, similar to Notion or
Open http://localhost:8000 in your browser: Open http://localhost:8000 in your browser:
1. Create your admin account on first visit 1. In `sample.env`, set `APP_SECRET` (at least 32 characters — `openssl rand -hex 32`), `DB_PASSWORD`, and `APP_URL` to your public URL (e.g. `https://docs.example.com`)
2. Start creating pages and organizing your workspace 2. Deploy the stack and open the site — on first visit you create the workspace and admin account
3. Optionally configure SMTP in the compose environment for email invites 3. Start creating spaces and pages
## Environment Variable Notes ## Environment Variable Notes
@@ -28,8 +28,8 @@ Open http://localhost:8000 in your browser:
| `DOCMOST_RESTART` | Restart policy for all services (default: `unless-stopped`) | | `DOCMOST_RESTART` | Restart policy for all services (default: `unless-stopped`) |
| `DOCMOST_PORT` | Published port for the web UI (default: `8000`) | | `DOCMOST_PORT` | Published port for the web UI (default: `8000`) |
| `VOL_PATH` | Base path for persistent data volumes (default: `/data`) | | `VOL_PATH` | Base path for persistent data volumes (default: `/data`) |
| `APP_URL` | Public-facing URL of your Docmost instance | | `APP_URL` | Public-facing URL of your Docmost instance (used in links and invites; must match the URL you browse to) |
| `APP_SECRET` | Secret key used for encryption and sessions — generate a long random string | | `APP_SECRET` | Secret key for encryption and sessions — **must be at least 32 characters** or Docmost will refuse to start (`openssl rand -hex 32`) |
| `DB_PASSWORD` | Password for the PostgreSQL database user | | `DB_PASSWORD` | Password for the PostgreSQL database user |
## Volume Notes ## Volume Notes
@@ -43,7 +43,7 @@ Open http://localhost:8000 in your browser:
## Network Notes ## Network Notes
- `proxy` — external network for reverse proxy access to the Docmost web UI - `proxy` — external network for reverse proxy access to the Docmost web UI
- `docmost_internal` — internal bridge network for communication between Docmost, PostgreSQL, and Redis - `internal` — bridge network for Docmost ↔ PostgreSQL/Redis; the database and Redis are only on this network
Create the proxy network once with: Create the proxy network once with:
@@ -57,13 +57,16 @@ This is a multi-service stack — use `docker compose` instead of individual `do
## Additional Notes / Gotchas ## Additional Notes / Gotchas
Nothing specific to this stack so far. - **`APP_SECRET` length:** the default `ChangeThisPassword` is too short on purpose — the container won't start until you set a real 32+ character secret.
- **Reverse proxy:** in Nginx Proxy Manager point the host at `docmost:3000` and enable **Websockets Support** — real-time collaborative editing depends on it.
- **Email (invites, password reset):** not configured by default. Add `MAIL_DRIVER=smtp`, `SMTP_HOST`, `SMTP_PORT`, `SMTP_USERNAME`, `SMTP_PASSWORD`, `MAIL_FROM_ADDRESS`, `MAIL_FROM_NAME` to the `docmost` service environment — see the [Docmost docs](https://docmost.com/docs/self-hosting/environment-variables).
- **Postgres upgrades:** don't bump `POSTGRES_IMAGE` major versions (e.g. 16 → 17) on an existing data dir; dump and restore instead.
## Dockhand Stack, Deploy from Git ## Dockhand Stack, Deploy from Git
- **Cookbooks Repository** - **Cookbooks Repository**
- **stackname:** docmost_dev - **stackname:** docmost
- **Compose file path:** docmost_dev/compose.yaml - **Compose file path:** docmost/compose.yaml
- **Additional env file (optional):** docmost_dev/sample.env - **Additional env file (optional):** docmost/sample.env
Load `docmost_dev/sample.env` into the Environment variables in Dockhand, then create the Stack. Load `docmost/sample.env` into the Environment variables in Dockhand, then create the Stack.
docmost_dev/compose.yaml → docmost/compose.yaml
+6 -6
View File
@@ -6,14 +6,14 @@ services:
- ${VOL_PATH:-/data}/docmost/storage:/app/data/storage - ${VOL_PATH:-/data}/docmost/storage:/app/data/storage
environment: environment:
- APP_URL=${APP_URL:-http://localhost:8000} - APP_URL=${APP_URL:-http://localhost:8000}
- APP_SECRET=${APP_SECRET} - APP_SECRET=${APP_SECRET:-ChangeThisPassword}
- DATABASE_URL=postgresql://docmost:${DB_PASSWORD:-ChangeThisPassword}@db:5432/docmost?schema=public - DATABASE_URL=postgresql://docmost:${DB_PASSWORD:-ChangeThisPassword}@db:5432/docmost?schema=public
- REDIS_URL=redis://redis:6379 - REDIS_URL=redis://redis:6379
ports: ports:
- "${DOCMOST_PORT:-8000}:3000" - "${DOCMOST_PORT:-8000}:3000"
networks: networks:
- proxy - proxy
- docmost_internal - internal
depends_on: depends_on:
db: db:
condition: service_started condition: service_started
@@ -30,7 +30,7 @@ services:
- POSTGRES_USER=docmost - POSTGRES_USER=docmost
- POSTGRES_PASSWORD=${DB_PASSWORD:-ChangeThisPassword} - POSTGRES_PASSWORD=${DB_PASSWORD:-ChangeThisPassword}
networks: networks:
- docmost_internal - internal
redis: redis:
image: ${REDIS_IMAGE:-redis:7-alpine} image: ${REDIS_IMAGE:-redis:7-alpine}
@@ -38,10 +38,10 @@ services:
volumes: volumes:
- ${VOL_PATH:-/data}/docmost/redis:/data - ${VOL_PATH:-/data}/docmost/redis:/data
networks: networks:
- docmost_internal - internal
networks: networks:
docmost_internal:
driver: bridge
proxy: proxy:
external: true external: true
internal:
driver: bridge
docmost_dev/sample.env → docmost/sample.env
View File