Install ยท v1.0.5

Install Pullsight on your own host

This page serves the configuration package only. Application images are pulled from GHCR. Downloading the package does not require an account. After installation, people sign in on the dashboard you host.

Package and images

The zip is the Compose file, environment templates, checksum manifest, image digests, and an empty images/ directory. It does not contain the application images and it does not contain a filled-in configuration.

Use that same tag for every Pullsight image:

  • ghcr.io/pullsight-inc/pullsight-db:v1.0.5
  • ghcr.io/pullsight-inc/pullsight-api:v1.0.5
  • ghcr.io/pullsight-inc/pullsight-web:v1.0.5

Digests for a connected install are in IMAGE_DIGESTS.txt. This release was published to GHCR. Do not pin production to the moving latest tag.

db  ghcr.io/pullsight-inc/pullsight-db:v1.0.5  sha256:7f7d2cb5477ed38ee68a8b4861ada9f7ef60fe80985785fc02e4fb455b358d30
api ghcr.io/pullsight-inc/pullsight-api:v1.0.5 sha256:319fc18f5300f7cae7ee7287233cc84d4ad2c4f449adff3f6b3bceaa35de6c3d
web ghcr.io/pullsight-inc/pullsight-web:v1.0.5 sha256:12d9d626d7920b9cc011b18f5f331eaf626260b92d31746fcf66d95ca3cd5e0b

SHA256SUMS lists the offline image archives from the GitHub release. Those archives are not hosted on this website. A connected install does not need them.

Requirements

  • Docker Engine 24 or newer, and Docker Compose v2.
  • A network path to ghcr.io for a connected install.
  • Free disk for the three images (about 2 GB once unpacked on v1.0.5), the Redis image (about 60 MB), and the Postgres volume as reviews accumulate.
  • A public HTTPS URL, or a tunnel, when GitHub App webhooks and OAuth callbacks must reach the host. A private trial can stay on http://localhost:3000.
  • Optional: Ollama on the host for local inference. The package default is qwen2.5-coder:3b.

1. Unpack and create the env files

unzip pullsight-selfhost-v1.0.5-config.zip
cd self-host
cp .env.example .env
cp web.env.example web.env

Generate new values for PULLSIGHT_SECRET_KEY, PULLSIGHT_PROVISION_SECRET, PULLSIGHT_ENCRYPTION_KEY, PULLSIGHT_API_KEY_SALT, and AUTH_SECRET. Set POSTGRES_PASSWORD and REDIS_PASSWORD. Compose will not start until those passwords are set. The examples ship with empty passwords and placeholder strings. Replace the placeholders. Do not reuse them.

PULLSIGHT_PROVISION_SECRET must be the same value in .env and web.env. Avoid @ : / ? # in passwords, because they are interpolated into database and Redis URLs.

2. Pin this release

Set the tag in .env to the value recorded in .image-tag. For this package that value is v1.0.5. One tag covers the database, the API, and the web image. The worker uses the API image.

PULLSIGHT_IMAGE_TAG=v1.0.5
PULLSIGHT_IMAGE_PREFIX=ghcr.io/pullsight-inc

Optional digest pins, copied from IMAGE_DIGESTS.txt:

PULLSIGHT_DB_DIGEST=sha256:7f7d2cb5477ed38ee68a8b4861ada9f7ef60fe80985785fc02e4fb455b358d30
PULLSIGHT_API_DIGEST=sha256:319fc18f5300f7cae7ee7287233cc84d4ad2c4f449adff3f6b3bceaa35de6c3d
PULLSIGHT_WEB_DIGEST=sha256:12d9d626d7920b9cc011b18f5f331eaf626260b92d31746fcf66d95ca3cd5e0b

3. Pull the images and start

docker compose pull
docker compose up -d

This starts Postgres, Redis, the API, at least one review worker, and the web UI. Open the dashboard at http://localhost:3000, or at the public HTTPS URL you configured, and sign in there. That sign-in belongs to your installation.

The guide shipped as SELF_HOST.md in the zip covers upgrades, isolated installs, webhooks, and OAuth callbacks. The same public guide is the Pullsight documentation.

Models and privacy

A local Ollama model keeps the review on your machines: the diff is not sent to an external API. If you set an external provider, the content needed for the analysis is sent to the provider you chose. Keys remain in the server environment.

Online platform

Coming soon. For now, install Pullsight on your own infrastructure with the package above.