kegtrack

Download

Download kegtrack

Built from source with Docker Compose. No Rust, Node or PostgreSQL is needed on the machine.

  1. Clone and set the secrets

    No default value exists: fill in every password in .env.

    $ git clone https://github.com/selfhostr/kegtrack.git
    $ cd kegtrack
    $ cp .env.exemple .env  # fill in the secrets
    $ chmod 600 .env
  2. Start it

    This starts Caddy, the application, PostgreSQL and the backups.

    $ docker compose up -d --build
    $ docker compose ps  # services must be healthy
  3. Create the first brewery

    The admin password is shown only once.

    $ docker compose run --rm app provisionner-brasserie \
      --nom "Brasserie du Phare" --slug phare --prefixe-qr PHARE \
      --admin-email [email protected] --admin-nom Martin --admin-prenom Claire
  4. Add demo data, if you want

    One year of demonstration history.

    $ docker compose run --rm app semer-demonstration --locataire phare --futs 3000

The camera requires HTTPS: browsers block it on plain http:// addresses. Use a domain name with a certificate or a tunnel. Details are in the docs.

Requirements

  • Docker with Compose
  • HTTPS for the phone camera
  • Labels that survive washing: engraved plates or industrial polyester

Versions and images

  • Latest releasev1.0.0
  • Application imageBuilt on your machine
  • Other imagescaddy:2-alpine, postgres:17-alpine
  • Default port6666
  • Updategit pull && docker compose up -d --build

Support the project

Every selfhostr project is free and has no company behind it. If one saves you time, a donation pays for the test hardware and for the time it takes.

Sponsor us on GitHub