Pantry RaiderGet started
Pick the install that matches where you want it to run. Every path ends at the same web setup wizard, so there are no config files to edit.
Option 1: Docker (server, NAS, Proxmox, TrueNAS, Unraid)
Needs Docker with Compose v2. One command pulls the prebuilt image and starts Pantry Raider plus a bundled Grocy inventory backend:
curl -fsSL https://raw.githubusercontent.com/Syracuse3DPrinting/PantryRaider/main/scripts/install.sh | bashThen open http://YOUR-HOST:9284/setup and follow the wizard: set a UI password, add your Grocy and AI provider keys, test, save.
Optional extras start with Compose profiles:
| Profile | Adds |
|---|---|
with-grocy | Grocy, the inventory backend (on by default in the install script) |
with-mealie | Mealie for recipes, meal plans, and shopping lists |
with-ollama | Ollama for fully local AI, no cloud key needed |
Option 2: Home Assistant add-on
Runs inside Home Assistant OS or Supervised, with the UI in the sidebar and no separate login (Home Assistant handles auth through Ingress). InSettings > Add-ons > Add-on Store, add the repositoryhttps://github.com/Syracuse3DPrinting/PantryRaider, installPantry Raider, and start it.
Option 3: Raspberry Pi kitchen appliance
Turn a Raspberry Pi into a dedicated Pantry Raider appliance, optionally with a touchscreen kiosk and a Stream Deck. Flash stock Raspberry Pi OS Lite with Raspberry Pi Imager (set wifi, hostname, and SSH there), boot, SSH in, and run:
curl -fsSL https://raw.githubusercontent.com/Syracuse3DPrinting/PantryRaider/main/install.sh | bashThe installer detects the board, any attached display, and any Stream Deck, then asks which deployment mode and add-ons you want. It can also run as a thin kiosk remote that drives a display and Stream Deck for a Pantry Raider server hosted elsewhere.
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 Pi Zero 2 W works in this role |
One auto-update switch covers the fleet: servers update through Watchtower, appliances over the air, and satellites follow their server's version.
AI is optional
Everything except photo analysis and barcode enrichment 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 open source under the PolyForm Noncommercial license: free for personal, educational, and non-commercial use.
Does my data leave my network?
Not unless you ask it to. Inventory lives in your own Grocy database on your hardware. The optional outbound calls are the ones you configure: a cloud AI provider (skippable with Ollama), Open Food Facts barcode lookups (can be disabled), and rclone cloud backups if you set them up.
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. Mealie is optional and only needed for meal planning and shopping lists.
Can it run fully offline?
Yes. With Ollama for AI and barcode enrichment disabled, nothing requires internet access, including startup and restarts.
Is it stable?
Pantry Raider is pre-1.0 and under active development. It is running in real kitchens today, updates ship frequently, and backups are built in.
More detail
The GitHub repository has the full README, compose files, and hardware guides, and the documentation indexlinks out to the project wiki for the longer guides.