Skip to content
Robert Einsle edited this page Nov 16, 2026 · 16 revisions

Holdout handbook

Holdout is a mobile-first web app that helps families build and keep an emergency food and water supply, and eat it before it expires. It is self-hosted: one installation serves one household, with an account per person and no passwords. In an emergency it works offline through the paper printout and the offline copy on every phone.

This handbook is the source of the project wiki. Edit the files in handbuch/ and rebuild the wiki with scripts/build-wiki.py; never edit the wiki by hand.

Pages

  • Dashboard: the start page with days of supply, "eat soon" and recent activity
  • Installation: run Holdout with Docker and Coolify, PostgreSQL, environment variables, updates, backups
  • Sign-in and security: passkeys, email links, authenticator app, recovery codes
  • Household: household size, target days, "eat soon" window, stock against target
  • Categories: food and water categories and the daily need per person (BLE values)
  • Scanning: scan a barcode with the phone camera to add a batch or a new product
  • Products: the products in your supply, with category and package size
  • Shopping list: what is still missing to reach the target, to share or copy
  • Batches: how many packages you have and when they expire
  • Printout: the paper emergency copy for a power or network outage
  • Offline copy: the copy of the supply every phone keeps for when the server is unreachable
  • Locations: where the supply is kept
  • History: taking packages out, and who changed what
  • Equipment: home pharmacy, power outage, hygiene, documents, cash, grab bag, fire safety: checklists with expiry dates and a check log
  • Family: household setup, owner and member roles, invitations, profile and language
  • Design: colours and contrast rules
  • Development: local setup, tests, conventions, documentation workflow

Status

Version 0.1 is in progress. Available so far: household setup, household size and target days with the resulting target amounts per category, products with barcode lookup and camera scanning, batches with best-before dates, storage locations, taking packages out with a history of who did what, the stock compared with the targets, the dashboard, the shopping list, the printout (paper emergency copy), the offline copy on phones, equipment checklists with a check log, sign-in without passwords, and family invitations.

Clone this wiki locally