ToHuus Hub
GitHub
ToHuus Hub keeps track of what's in the fridge, where the parcel tape lives and what's for dinner. A free, open-source app for the whole family, running on your own server.
Allns an sien Platz.Low German for "everything in its place". That's the whole idea.
ToHuus Hub shows up in small moments, the ones where you'd otherwise shout up the stairs. Here's what that looks like on an ordinary Saturday and Sunday.
The usual Saturday question. ToHuus Hub fills the empty evenings with recipes that fit what's already in the house: what has to go first, what you like, what you haven't had in a while. One more tap puts every missing ingredient on the shopping list.
On Wednesday friends ask you out? "We're eating out tonight" moves the rest of the week back by a day.
Wednesdayout for pizza. plan just moves.
The REWE order is still being packed, so Lea goes in for the few things it forgot. In store mode the list is sorted by aisle, in the order she usually walks that shop, and it keeps working at the back where the signal gives up.
At home you type "wrapping paper and 2 milk" into the list and it shows up on her phone a moment later. Anything someone tapped "I'll get it" on carries their name, so nobody buys the cream twice. At the till, "done shopping" books the whole basket into stock.
Lea · REWEfrozen aisle first, then out.
Upload the pickup notice and the eBon instead. ToHuus Hub reads both, matches the order against the receipt and shows what changed: the substitution, the item that wasn't there, the new product that still needs a shelf. You check it once and it's in stock.
Receipt photos, QR receipts and pasted text work too. Right now the parsers know REWE; other shops are welcome as contributions.
Reviewthey swapped the tape. fine.
Every room gets a short direction and every thing can get an exact spot. Type "tape" and the answer is: utility room, shelf by the door, box "post & parcels".
That box has a QR label we printed from the app. Point the phone camera at it and one tap takes a roll out of stock. If it was the last one, the tape goes straight on the list.
Utility roombox "post & parcels"
The Today screen shows the whole house at once: what needs using up, what's gone, what's running low, what's on the list and tonight's best recipe. Finished the yoghurt? One tap.
Opened things run on their own clock. The pesto jar from Tuesday and the chili left over from Thursday sit under "eat first", and something you put in the freezer gets a new date instead of quietly expiring.
Fridgemilk!! (already on the list)
Two taps start a party. The TV shows a QR code and what's on the menu tonight. Guests scan it and order from their own phones, picking from what's actually in the house. The kitchen works through new, in progress and ready, and the TV shows which numbers can be picked up at the counter.
If two people want the last cola, the first order gets it. When nobody has ordered for a while the party ends by itself, and the recap puts whatever ran out on the shopping list.
Most evenings it's smaller. Lea on the sofa orders a cappuccino, extra hot, and whoever is in the kitchen gets a push. If you like, the whole app dresses up as "Fredirando", a slightly silly home-delivery service in orange.
Lea · sofacappuccino, extra hot
After a party the numbers drift. Quick check goes through one shelf, one tap per item: right, less, empty, gone. Butter, right. Yoghurt, gone. About a minute later the count is honest again, and the week plan works from what's really there.
Once a month a small card shows what got thrown away. It doesn't scold. It just helps you notice.
Fridgedone before the coffee.
Instead of a page of notes on the counter, she gets a link. It opens exactly the "where is what" search, with your note on top: emergency numbers, bedtime, which story has to be read twice.
Guest links show names and places, never quantities, and they expire on their own.
For the sitterbedtime 7:30. story first!
The rules we built the app around. They're the reason it still gets used after the first week.
Fruit, veg and bread are just full, half, low or empty. Packets and bottles get counted. Coffee from the machine isn't tracked at all.
Stock comes in through receipts, orders, photos and the barcode scanner. Typing is the fallback, not the plan.
Built for brains that forget things: few taps, gentle nudges instead of a wall of data, and it still works on a bad day.
Babysitter and guest links show places and the menu. Quantities, the rest of the house and your settings stay private.
An open jar doesn't keep like a closed one. Opened, frozen and leftover things get their own dates and move up to "eat first".
Water filter, smoke detectors, descaling, tyres, passports. They come back on their own, and the spare filter cartridge lands on the list.
One SQLite file on your own server. No account with us, no telemetry, no cloud in between.
It's a web app. Add it to your phone's home screen, or leave it open on the tablet in the kitchen. On wider screens it opens up into a calm layout with a sidebar.
We're Till and Lea, a family with a small kid in northern Germany. Our house has a fridge, a chest freezer in the cellar, a pantry that's never quite tidy and a utility room where things go to hide.
For years one of us knew where everything was and what was running out, and the other one asked. That works until it doesn't: the third bottle of ketchup, the parcel tape nobody can find, the "didn't you buy milk?" at six in the evening.
So we built ToHuus Hub for ourselves, with a lot of help from Claude. The one rule: it has to work on a tired Tuesday, so nobody has to keep it all in their head. Now it runs on a small server at home and everyone in the house uses it.
It's free and AGPL-licensed. There's no company behind it, no paid tier and nothing to sign up for. If it helps your household too, that makes us happy. Issues and pull requests are welcome.
Till & Lea
One Docker container, one SQLite file. It runs happily on a NAS or a small VPS and never phones home. Anything that talks to the outside world is optional, and you decide whether to switch it on.
Danke. See you at home.
All you need is Docker, on a NAS at home or a small VPS. No licence key, no account, no cost.
BASE_URL, your name and a password.docker compose up -d, then open http://localhost:8080.SEED_DEMO: "true" before the first start and you get a demo household.services: tohuus: image: ghcr.io/tillheidrich/tohuus-hub:latest container_name: tohuus-hub restart: unless-stopped ports: - "8080:8080" volumes: - ./data:/data environment: BASE_URL: https://home.example.org ADMIN_NAME: Alex ADMIN_PASSWORD: change-me LANGUAGE: en # or de SEED_DEMO: "false" # optional, for photo imports: # VISION_BASE_URL: https://api.mistral.ai/v1
git clone https://github.com/tillheidrich/tohuus-hub.git cd tohuus-hub cp .env.example .env docker compose up -d --build
"Moin" is how the north says hello, at any time of day. Put ToHuus Hub on your own server and let the house do the remembering.