Get started

GHCR image

Pull the published image and pin it when you need a recoverable instance.

The Publish Docker image to GHCR workflow publishes ghcr.io/lucas-lepajollec/astroguide after validating pushes to main. Convenience tags include latest on the default branch. Recoverable installs should replace latest in the Compose image: line with a sha-<full-commit> tag or image digest.

The current public release is v0.1.3. The deleted historical v1.0.0 tag remains unsupported and must not be recreated.

docker pull ghcr.io/lucas-lepajollec/astroguide:latest

To pin the Compose image, edit docker-compose.yml:

image: ghcr.io/lucas-lepajollec/astroguide:sha-<full-commit>
docker compose up -d

Record the digest you actually started (docker compose images or docker image inspect) before the next pull.

Architectures

The workflow builds linux/amd64 and linux/arm64. Availability of a particular architecture depends on the latest successful publication.

Repository Compose files

FileImage source
docker-compose.ymlghcr.io/lucas-lepajollec/astroguide:latest
docker-compose.build.ymllocal build tagged astroguide:local

Pull from GHCR for a normal instance. Use the build overlay when validating a local change. Update and rollback steps are in Updates.