Apps — Cellar

Stock, by codex id

Inventory for beer shops and breweries. Stock, bundles, suppliers, presales, and a live link to your webshop. Beers come from the codex, so you never type one twice.

01 — What it is

The codex in, sales out

One beer id from register to receipt.
The codex

Beers, breweries and styles mirrored one-to-one. Registry ids are the primary keys, so a beer is the same beer everywhere.

synced from the UI
Cellar

Self-hosted, two containers, one Postgres. Everything on the shelf points at a codex id.

  • Stock units, suppliers, deliveries
  • Bundles sets sold as one
  • Presales sold before it exists
  • Holds reserved during checkout
AGPL-3.0Docker image
Your webshop

Reads your stock, holds it during checkout, records each sale.

Your team

The web UI. Count, restock, bundle, publish.

The codex, again

Brewery mode: author beers here, Cellar publishes your feed.

02 — Start using it

Four steps to a stocked shelf

No code. A Docker host and a browser.
  1. 01
    Run it

    Cellar ships as a Docker image. Start it next to a Postgres, open it in your browser, create the first account.

    Docker image · Postgres
  2. 02
    Sync the codex

    Press Sync registry. Every beer, brewery and style in the codex is now in your cellar, ready to stock.

    Beers → Sync registry
  3. 03
    Stock it

    Find a beer, add it to inventory. Record suppliers and deliveries, group beers into bundles, open presales.

    Inventory · Bundles · Presales
  4. 04
    Connect your shop

    Create a shop and its key, hand it to whoever runs your webshop. It reads your stock and records each sale.

    Shops → new key

Brewing, not selling? Bind Cellar to your codex brewery under Settings, author your beers, publish. Cellar publishes your brewery feed and the codex pulls it in — ids stay permanent.

Source on Codeberg