No description
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Bob Parsons 7cb60ff556
All checks were successful
Deploy ZenNotes / deploy (push) Successful in 9s
bump zennotes to 2.25.0
Was pinned at 2.8.0. 2.25.0 is the current release (published
2026-08-07) and brings the self-hosted server work from 2.19.0-2.25.0:
remote vaults for desktop/web/CLI clients, vault-stored settings shared
across clients, and server-backed asset and database operations.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-07 20:06:39 -05:00
.forgejo/workflows remove logging, secret corrected 2026-06-28 17:57:28 -05:00
.env.example reset 2026-06-28 17:28:29 -05:00
.gitignore reset 2026-06-28 17:28:29 -05:00
docker-compose.yml bump zennotes to 2.25.0 2026-08-07 20:06:39 -05:00
README.md bump zennotes to 2.25.0 2026-08-07 20:06:39 -05:00

ZenNotes Deployment

Docker Compose deployment for a self-hosted ZenNotes server at notes.bobparsons.dev.

Runtime Shape

  • adibhanna/zennotes:2.25.0 serves the app and Go API on port 7878.
  • Traefik terminates TLS and routes notes.bobparsons.dev over the external traefik network (no host port is published).
  • The Markdown vault stays on the host at /home/server/zennotes/vault (mounted at /workspace).
  • ZenNotes server data lives at /home/server/zennotes/data (mounted at /data).
  • The deploy workflow exports secrets from Infisical to .env; Docker Compose substitutes ZENNOTES_AUTH_TOKEN into the container environment.

Required Forgejo Variables

  • INFISICAL_PROJECT_ID
  • INFISICAL_API_URL optional, defaults to https://infisical.bobparsons.dev

Required Forgejo Secrets

  • INFISICAL_CLIENT_ID
  • INFISICAL_CLIENT_SECRET

Required Infisical Keys

  • ZENNOTES_AUTH_TOKEN

Generate the token with:

openssl rand -hex 32

Host Prerequisites

  • DNS for notes.bobparsons.dev points to the Traefik host.
  • Docker and Docker Compose plugin are installed on the Forgejo deploy runner host.
  • The Forgejo deploy runner has Docker socket access.
  • The external traefik Docker network exists or can be created by the runner.

Deploy

Push to main or run the Deploy ZenNotes workflow manually.

After the first deploy, open https://notes.bobparsons.dev, enter the ZENNOTES_AUTH_TOKEN value, and select the mounted vault folder from the server-side picker.