No description
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
All checks were successful
Deploy ZenNotes / deploy (push) Successful in 9s
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> |
||
| .forgejo/workflows | ||
| .env.example | ||
| .gitignore | ||
| docker-compose.yml | ||
| README.md | ||
ZenNotes Deployment
Docker Compose deployment for a self-hosted ZenNotes server at notes.bobparsons.dev.
Runtime Shape
adibhanna/zennotes:2.25.0serves the app and Go API on port7878.- Traefik terminates TLS and routes
notes.bobparsons.devover the externaltraefiknetwork (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 substitutesZENNOTES_AUTH_TOKENinto the container environment.
Required Forgejo Variables
INFISICAL_PROJECT_IDINFISICAL_API_URLoptional, defaults tohttps://infisical.bobparsons.dev
Required Forgejo Secrets
INFISICAL_CLIENT_IDINFISICAL_CLIENT_SECRET
Required Infisical Keys
ZENNOTES_AUTH_TOKEN
Generate the token with:
openssl rand -hex 32
Host Prerequisites
- DNS for
notes.bobparsons.devpoints to the Traefik host. - Docker and Docker Compose plugin are installed on the Forgejo deploy runner host.
- The Forgejo
deployrunner has Docker socket access. - The external
traefikDocker 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.