Prizen

Prizen is a self-hosted price tracker for marketplace products. It records price and availability history and sends record-low or target-price alerts to Discord or Telegram. No Prizen cloud account or control plane is required.

Quick links: Install · Status · Versions · User guide · Troubleshooting · Release notes

Install

The current stable version is v0.2.0. It runs the app, tracker, PostgreSQL, automatic migrations, and persistent secret initialization as one Compose application.

Docker

Requires Docker Compose 2.34 or newer:

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

Podman

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

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

Open http://127.0.0.1:3000. Set PRIZEN_PORT before installation to use another host port. Back up both the pgdata and prizen_secrets volumes; both are required for recovery.

Application images, Compose applications, and release assets use the same version. Pin versions for reproducible installs; latest is reserved for stable releases.

Status

Prizen v0.2.0 is the stable local Tracking MVP. Amazon product-page retrieval is the default tracking method. Eligible owners can optionally configure Amazon Creators API credentials, which are encrypted in the local database. See Amazon data access for limitations.

Versions

See GitHub Releases for available versions, features, changes, and installation assets. Pin an explicit version for reproducible deployments.

Documentation

• Wiki home
• Installation · Configuration
• Updating and rollback · Backup and restore
• Amazon tracking · Notifications
• Troubleshooting · Releases
• Engineering documentation · Production reverse proxy · Backup, restore, and upgrades · Tracking MVP acceptance checklist
• Contributing · Security · Changelog
• Project roadmap

License

Prizen is licensed under the Apache License 2.0.