Installation

Installation

The current stable version is v0.1.0.

Install a published release

Published releases are the normal installation path. Prizen creates PostgreSQL, generates secrets, runs migrations, and starts the app and tracker automatically.

Docker

Docker Compose 2.34 or newer:

docker compose -f oci://ghcr.io/samsterzero/prizen-stack:0.1.0 up -d --wait

Podman

curl --fail --location --output compose.release.yaml \
  https://github.com/SamsterZero/Prizen/releases/download/v0.1.0/compose.release.yaml

PRIZEN_IMAGE=ghcr.io/samsterzero/prizen:0.1.0 \
  podman compose -f compose.release.yaml up -d --wait

Open http://127.0.0.1:3000. Set PRIZEN_PORT before installation to use another host port.

The stack creates persistent pgdata and prizen_secrets volumes. Do not delete them during an upgrade.

Run the current source

This path is for contributors testing an unreleased branch. From the repository root:

Docker

docker build -t prizen:local .
PRIZEN_IMAGE=prizen:local docker compose -p prizen-source \
  -f compose.release.yaml up -d --wait

Podman

systemctl --user enable --now podman.socket
podman build -t docker.io/library/prizen:local .
PRIZEN_IMAGE=docker.io/library/prizen:local podman compose -p prizen-source \
  -f compose.release.yaml up -d --wait

If port 3000 is occupied, prefix the Compose command with PRIZEN_PORT=3001 ORIGIN=http://localhost:3001 and open http://127.0.0.1:3001.

Stop while preserving data:

PRIZEN_IMAGE=prizen:local docker compose -p prizen-source -f compose.release.yaml down

Replace docker and the image name with their Podman equivalents when applicable.