mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-07 04:12:04 +00:00
Marc-André Bombeck
c903c7f1b1
Surface the load-bearing first-run vars in docker-compose.yml and the README quick-start: secret generation, the SESSION_COOKIE_SECURE=false LAN note, the single persistent volume, and a /api/version verify step. Add an Unraid Community Applications template plus a NAS walkthrough covering the external Postgres setup, and a Portainer app template referencing the compose stack.
1.8 KiB
1.8 KiB
HealthLog on Portainer
HealthLog ships a Portainer app template that deploys the app and its
PostgreSQL 16 database as one stack from the project docker-compose.yml.
Add the template
-
In Portainer, go to Settings → App Templates.
-
Set the URL to the raw template file:
https://raw.githubusercontent.com/MBombeck/HealthLog/main/docs/self-hosting/portainer/templates.json -
Save. HealthLog now appears under App Templates.
Deploy
- Open App Templates → HealthLog.
- Fill in the variables. Generate each secret with
openssl rand -hex 32(a 64-character hex string):POSTGRES_PASSWORDENCRYPTION_KEY— back this up; losing it makes encrypted data unrecoverableAPI_TOKEN_HMAC_KEYSESSION_COOKIE_SECURE— set tofalsefor plain-HTTP / LAN access, or login silently fails. Set totrueonly behind an HTTPS reverse proxy.NEXT_PUBLIC_APP_URLandAPP_URL— how you reach the app, e.g.http://nas:3000orhttps://healthlog.example.com.
- Deploy the stack. The app waits for PostgreSQL, runs database migrations on first boot, then starts serving.
- Open the app URL. The first registered user becomes the admin.
Verify the running version:
curl -s http://<host>:3000/api/version
Notes
- Persistent state lives in one named volume (
pgdata, the Postgres data dir); the app container is stateless. Back up the database to back up everything. - Pin a release tag (
HEALTHLOG_IMAGE_REF=:vX.Y.Z) for deliberate upgrades, or track:latest. Skim the CHANGELOG and back up before upgrading. Migrations are forward-only. - For passive discovery you can also submit this template to the community aggregator at https://github.com/Lissy93/portainer-templates.