Files
updater/README.md
T
2026-07-14 12:10:44 +03:00

1.4 KiB

FromChat Updater

Watches GitHub tags and container packages for backend + frontend repos. When a newer semver tag exists in both and all required fromchat/* images are published, regenerates compose.yml (via the deployment merge script) and restarts the stack.

Environment (.env)

Variable Description
GITHUB_TOKEN PAT with read:packages + repo
BACKEND_REPO e.g. https://github.com/fromchat-messenger/backend.git
WEB_REPO e.g. https://github.com/fromchat-messenger/web.git
DEPLOYMENT_REPO https://github.com/fromchat-messenger/app.git (deployment scripts)
DEPLOYMENT_REPO Deployment repo for generate-compose.py
COMPOSE_PROJECT_DIR Host path to the stack (compose.yml parent directory)
FROMCHAT_COMPONENTS Comma list: backend,frontend,caddy,updater
CHECK_INTERVAL_SECONDS Poll interval (default 60)

Only compose.yml from the stack directory is mounted into the updater container (read-write at /fromchat/compose.yml). The current release is read from image tags inside that file.

Create token: GitHub PAT (read:packages + repo)

Run standalone

cd ~/fromchat-server/updater
docker compose --env-file .env up -d

The installer sets this up automatically when updater is selected.