Skip to content
Gittensory
Self-hosting

Releases and images

How to consume official self-host images, pin versions, build custom images, and keep source maps aligned.

Image tags

version
Pinned release tag. Use this in production.
latest
Moves with the newest release. Useful for trials, not for controlled production.
sha
Immutable commit-derived tag for exact provenance and rollback.
docker pull ghcr.io/jsonbored/gittensory-selfhost:0.1.0
docker pull ghcr.io/jsonbored/gittensory-selfhost:latest
bash

Upgrade flow

  1. Read release notes for env, migration, or behavior changes.
  2. Back up the database or confirm Litestream health.
  3. Pull the new image tag.
  4. Recreate the app container.
  5. Check /ready, logs, queue metrics, and one test PR.
docker compose pull gittensory
docker compose up -d gittensory
curl http://localhost:8787/ready
bash

Custom images

Custom builds are useful for testing local changes or including subscription CLIs. They should not contain secrets.

docker compose build --build-arg INSTALL_AI_CLIS=true gittensory
docker compose up -d gittensory
bash

Sentry source maps

Official releases align GITTENSORY_VERSION, Sentry release ids, and uploaded source maps. For custom images, leave SENTRY_RELEASE unset unless you uploaded source maps for that exact built bundle.

Rollback

Roll back by pinning the prior image tag and recreating the container. Database migrations can make rollback harder, so keep backups and read release notes before upgrading a live maintainer instance.

← PreviousBackup & scalingNext →Security