holdout
Open source · free · self-hosted

Your family's emergency supply. Always know how long you'd last.

Holdout helps you build an emergency food and water supply, keep it up to date and eat it before it expires. Scan a barcode, enter the best-before date, and see how many days your household would last – and which category runs out first.

  • 0 €licence fees
  • 5languages
  • AGPL-3.0open source
  • Offlinecopy on paper and phone

Made for everyday life

A supply that stays fresh, not forgotten

Most emergency supplies are bought once and expire in the cellar. Holdout turns them into a living stock: you see what you have, what is missing and what to eat next – on the phone you already carry.

Scan instead of typing

Point the phone camera at a barcode. Name, package size and photo come from Open Food Facts, cached on your server so a known product works without internet.

Targets from your household

Enter how many adults and children live with you and how many days the supply should last. Holdout calculates the amount per category from the official German BLE values.

Days of supply at a glance

The dashboard shows how many days the whole supply lasts – as long as the category that runs out first, because 30 days of pasta do not help without water.

Eat it before it expires

Every package has a best-before date. The "eat soon" list shows what to use next; expired food is shown but never counted towards your target.

Shared with the family

Everyone uses their own phone and account, signs in without a password (passkey, email link or authenticator app) and picks their language. The history shows who took what out.

Your data, your server

Holdout runs on your own server. No telemetry, no accounts at a vendor, no subscription. The code is open for everyone to read and improve.

How it works

From empty shelf to "we're covered" in four steps

No spreadsheet, no guessing. Holdout does the arithmetic and tells you what to buy next.

  1. Set up the household

    Adults, children and how many days the supply should last. The BBK recommends 10 days.

  2. Scan what you have

    Scan each product, enter how many packages and the best-before date, and where they are stored.

  3. See how long it lasts

    Per category the stock against the target, and the days for the whole household.

  4. Refill and rotate

    The shopping list shows what is missing; eat what expires soon and take it out with one tap.

When it counts

Works when the power and the internet are gone

In a power cut the server, the router and maybe the mobile network are down. That is exactly when you need to know what you have. So Holdout keeps two copies that need no server at all.

Paper printout

An A4 copy in black and white for your emergency folder: how long the supply lasts, the need per day to ration by, what to eat first, and every package by storage location with a column for tally marks.

About the printout →

Offline copy on every phone

Each phone keeps the same content and updates it whenever Holdout is opened. When the server cannot be reached, every page opens the saved copy instead, clearly marked as offline.

About the offline copy →

Beyond food

Checklists for the home pharmacy, power outage, hygiene, documents, cash, grab bag, fire safety and staying informed, based on BBK guidance, with expiry dates and a check log. They are on the printout too.

About equipment →

How much is enough?

How much food and water per person per day

Holdout uses the daily amounts per person from the stock calculator of the German Federal Office for Agriculture and Food (BLE), based on 2,200 kcal per person and day. Here they are for one adult, and for a 10-day supply as recommended by the German Federal Office of Civil Protection and Disaster Assistance (BBK).

Children up to 12 years count like adults for food; for drinks Holdout uses 1.5 l per child and day. 1 l counts as 1 kg.
CategoryPer adult and day1 adult, 10 days2 adults + 1 child, 10 days
Drinks (1.5 l drinking + 0.5 l cooking)2.0 l20 l55 l
Grains, bread, potatoes0.33 kg3.3 kg9.9 kg
Vegetables, pulses0.40 kg4.0 kg12.0 kg
Fruit, nuts0.25 kg2.5 kg7.5 kg
Milk, dairy products0.25 kg2.5 kg7.5 kg
Eggs, meat, fish0.12 kg1.2 kg3.6 kg
Fats, oil0.033 kg0.33 kg1.0 kg

Sources: BLE stock calculator and BBK guidance. Holdout calculates these numbers for your household and target days automatically.

Everything in one place

What Holdout covers

A core and modules that plug in through registries. Every part is described in detail in the wiki.

Dashboard

Days of supply, what to eat soon, recent activity and a big scan button.

Read more →

Household & targets

Household size, target days and the stock against the target per category.

Read more →

Products & scanning

Products with package size and photo; barcode lookup via Open Food Facts.

Read more →

Batches

How many packages you have of each product and when they expire.

Read more →

Storage locations

Cellar, kitchen, garage: know where everything is, also on paper.

Read more →

History

Take packages out as eaten or thrown away; see who changed what and when.

Read more →

Shopping list

What is still missing to reach the target, rounded up, ready to share.

Read more →

Equipment

Non-food checklists with expiry dates, check intervals and a check log.

Read more →

Family & sign-in

Invitations, owner and member roles, passkeys, email links and authenticator app.

Read more →

Installation

Up and running in an afternoon

Holdout ships as a ready-made Docker image from the GitHub Container Registry. You need a small server, a domain with HTTPS and an SMTP account for sign-in links. No programming required.

  1. Server

    A small virtual machine or home server with Docker, for example managed with Coolify.

  2. Database and app

    Create a PostgreSQL database and start the Holdout image with its environment variables. The database is set up automatically on start.

  3. Get started

    Open your domain, create the household with its size, invite the family and scan your supply.

Step-by-step installation guide

FAQ

Frequently asked questions

What is Holdout?

Holdout is a free, open-source web app that helps a family build an emergency food and water supply, keep it up to date and eat it before it expires. You scan products with your phone, enter the best-before date, and Holdout shows how many days the supply lasts for your household and which category runs out first.

How much water do I need per person per day?

The German Federal Office for Agriculture and Food (BLE) calculates 2 litres per adult and day: 1.5 litres for drinking and 0.5 litres for cooking. Holdout uses 1.5 litres for children up to 12 years. For 2 adults and 1 child over 10 days that is 55 litres.

How many days should an emergency supply last?

The German Federal Office of Civil Protection and Disaster Assistance (BBK) recommends a supply for 10 days. In Holdout you set the target days for your household yourself; the default is 14 days.

Does Holdout work during a power cut or without internet?

Yes, through two fallbacks that need no server: a paper printout with the daily rations, what to eat first and the stock by location, and an offline copy of the same content that every phone keeps and opens automatically when the server cannot be reached. The live app itself needs the server; it is for managing the supply in normal times.

Is Holdout free?

Yes. Holdout is free software under the GNU Affero General Public License v3.0. There are no licence fees, no subscriptions and no tracking. You only pay for the server you run it on.

Where is my data stored?

On your own server. Holdout has no telemetry and sends your data to nobody. The only outside request is the optional barcode lookup at Open Food Facts, which sends just the barcode.

What do I need to run Holdout?

A small server that runs Docker, a PostgreSQL database, a domain with HTTPS and an SMTP account for sign-in links and invitations. The reference setup is Coolify; any Docker Compose host works.

Can the whole family use it?

Yes. One installation serves one household. The first person creates the household and invites the others; everyone signs in with their own account, without a password, and picks their own language.

Open source

Free software for every family

Holdout is licensed under the GNU AGPL-3.0. Every family may use, adapt and share it at no cost – improvements stay open for everyone. Ideas, wishes and bug reports are welcome as an issue on GitHub.

  • BackendLaravel 13, PHP 8.5
  • InterfaceFilament 5, Livewire, Tailwind 4
  • DatabasePostgreSQL
  • OperationDocker image, e.g. with Coolify
  • Product dataOpen Food Facts
  • LanguagesEN, DE, ES, PT, FR