Deployment modes
The setup wizard picks between three modes, so the same software fits very different homes:
| Mode | What it is |
|---|---|
| Server | Pantry Raider on a NAS, mini PC, or VM, connected to Grocy (and optionally Mealie) running alongside it |
| Pi appliance | Everything on one Raspberry Pi, with the kiosk auto-enabling when a display is attached |
| Kiosk satellite | A thin Pi that drives a touchscreen or Stream Deck for a server elsewhere on your network, pulling its config automatically. Even a 1 GB Pi 3B+ works in this role |
Updates arrive on their own: a Docker server through its bundled updater, a Pi appliance or a server set up with the install script from signed releases it checks before installing, and satellites follow their server's version.
Reach it from outside your kitchen
Out of the box the app serves plain HTTP on your home network. For HTTPS or remote access, put your own reverse proxy (Caddy, nginx, Traefik, or Pangolin) in front of it to handle TLS, or use Forager remote access, which publishes the app over HTTPS without opening a port. The platforms guide and the remote access guide cover both.
Anything that arrives through a reverse proxy or a tunnel counts as coming from the internet, even when the proxy runs on the same machine. A kitchen reached that way needs a password, and signing in from outside your home network also needs two-factor. Turn on two-factor in Settings, Security from a device at home. A kitchen with no password does not answer through a proxy at all. The security guide has the full rules.
The setup code
If you open the setup wizard from outside your home network, or you are locked out from outside before two-factor is on, the kitchen first asks for its setup code. It is in the app's log, on the newest line that begins Pantry Raider setup code. With Docker Compose or on a Raspberry Pi, run:
sudo docker logs foodassistant-service 2>&1 | grep "setup code"On Unraid, open the Docker tab, click PantryRaider, and choose Logs. In the Home Assistant add-on, open the add-on's Log tab. A code works once, within 24 hours. Setting up from a device on your home network does not need it.
AI is optional
Everything except the AI extras (photo and receipt scanning, product name cleanup, AI recipe writing, and shelf-life estimates) works with no AI provider at all. When you want it, bring a Gemini, OpenAI, or Anthropic API key, or run local models with Ollama for a fully private, offline-capable setup. Gemini has a generous free tier and is the default cloud choice.
Common questions
What does it cost?
Nothing for personal use. Pantry Raider is source available under the PolyForm Noncommercial 1.0.0 license: free for personal, educational, and other noncommercial use. Self-hosting has no subscription. Forager, the optional hosted companion, adds remote access and pooled AI from $10/year, and you never need it.
Does my data leave my network?
Your food data does not. Inventory lives in your own Grocy database on your hardware. The outbound calls are the ones you use or configure: a cloud AI provider (skippable with Ollama), an Open Food Facts lookup when you scan a barcode (type item names in by hand and none is made), weather forecasts from Open-Meteo (the panel can be turned off), recipe search from TheMealDB (can be turned off; your own library stays local), and rclone cloud backups if you set them up. Two small things are on from the start: the update check (GitHub) and a once-a-day download of the community shelf-life table from Forager, which carries nothing about you. Both can be turned off, and there is no telemetry. The what needs the internet page lists every one.
Do I need Grocy or Mealie accounts?
No accounts, they are self-hosted too. Grocy is the inventory backend and the install script starts it for you. Recipes and meal planning are built into Pantry Raider itself, and the shopping list lives in Grocy, so Mealie is fully optional; connect it only if you already use it.
Can it run fully offline?
Mostly, after the initial install. First-time setup needs internet to pull the images. From then on, with Ollama as the AI provider, day-to-day use, startup, and restarts work with no internet access. Turning a scanned barcode into a product name needs Open Food Facts, so offline you type the item name instead.
Is it stable?
Not yet. Pantry Raider is beta software, pre-1.0 and under active development. It runs in real kitchens today, but features and settings can still change between updates. Backups are built in: take one before you update, and report problems on GitHub issues.
More detail
The GitHub repository has the full README, compose files, and hardware guides, and the documentation index links out to the documentation site for the longer guides.