Install in one command

Get 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.

Try the demo first View on GitHub

Where it lands

One web setup wizard

However you install, you finish at /setup: set a password, add your Grocy and AI keys, run live connection tests, and save. No config files to edit, and every section saves on its own.

Raspberry Pi kitchen appliance

Turn a Raspberry Pi into a dedicated Pantry Raider appliance, optionally with a touchscreen kiosk and a Stream Deck.

Minimum hardware

Part	Minimum	Recommended
Board	Raspberry Pi 4B, 2 GB	Raspberry Pi 5, 4 GB or more
Storage	16 GB microSD	32 GB or more, A2-rated (or boot from SSD)
OS	Raspberry Pi OS Lite, 64-bit
Power	Official USB-C supply
Kiosk (optional)	—	DSI or HDMI touchscreen, plus a Stream Deck

The full stack (Pantry Raider plus Grocy) runs comfortably on a 2 GB Pi; add Mealie and you want 4 GB or more. Fully local Ollama AI is a mini-PC job (16 GB+) — on a Pi, use a cloud AI provider instead. An older 1 GB Pi 3B+ still earns its keep as a thin kiosk remote for a server elsewhere; a Pi Zero 2 W is too small even for that.

Install

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/Syracuse3DPrintingOrg/PantryRaider/main/install.sh | bash

The 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 (a Bandit) that drives a display and Stream Deck for a Pantry Raider server hosted elsewhere.

Prefer flash-and-go? Grab the pre-built SD image from the Releases page, flash it, boot, and skip SSH entirely — the SD image guide covers it.

Wiring up a sensor, a wired barcode scanner, a PoE HAT, or a STEMMA QT / Qwiic board? See which header pins each accessory uses — and where pin 1 is on the board.

🔌 Open the interactive GPIO guide

Mini PC kitchen server

An x86-64 mini PC (Intel N100 class or better) makes a quiet, always-on Pantry Raider box that runs the whole stack — and it is the best choice for fully local AI with Ollama. Run it headless for the rest of the house, or attach a touchscreen and it becomes its own kitchen kiosk.

Minimum hardware

Part	Minimum	Recommended
CPU	64-bit x86 (Intel N100 class)	N100 or better
RAM	4 GB	8 GB, or 16 GB or more for local Ollama AI
Storage	16 GB	32 GB or more, SSD or NVMe
OS	64-bit Linux with Docker and Compose v2	Debian or Ubuntu Server
Network	Ethernet or Wi-Fi	Ethernet for an always-on box

Install

Install Docker with Compose v2, then one command pulls the prebuilt image and starts Pantry Raider plus a bundled Grocy inventory backend:

curl -fsSL https://raw.githubusercontent.com/Syracuse3DPrintingOrg/PantryRaider/main/scripts/install.sh | bash

Then open http://YOUR-HOST:9284/setup and follow the wizard. For a fully local, private setup, add the with-ollama profile and pick Ollama as your AI provider — no cloud key needed.

Docker on a server or NAS you already run

Already have a NAS, Proxmox, TrueNAS, or Unraid box? Add Pantry Raider alongside your other services — it just 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/Syracuse3DPrintingOrg/PantryRaider/main/scripts/install.sh | bash

Then open http://YOUR-HOST:9284/setup and follow the wizard: set a UI password, pick an AI provider if you want one, test, save. A fresh install provisions its bundled Grocy automatically — no key pasting. On top of the password you can enable optional TOTP two-factor authentication — it works offline with any authenticator app — and a kiosk install on the local machine can skip the login screen entirely.

Prefer to do it by hand? Download docker-compose.prod.yml, save it as docker-compose.yml, and start the stack yourself:

curl -fsSLo docker-compose.yml https://raw.githubusercontent.com/Syracuse3DPrintingOrg/PantryRaider/main/docker-compose.prod.yml
docker compose up -d

On Unraid, skip the script: install the Pantry Raider template from Community Applications, or bring up the whole stack with the Docker Compose Manager plugin — the Unraid guide covers both.

Optional extras start with Compose profiles:

Profile	Adds
`with-grocy`	Grocy, the inventory backend (on by default in the install script)
`with-mealie`	Mealie as an optional recipe backend (recipes, meal plans, and shopping lists also work without it)
`with-ollama`	Ollama for fully local AI, no cloud key needed
`with-printing`	A CUPS print stack for label and document printing to network printers
`with-beszel`	Beszel host and container monitoring

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). In Settings > Add-ons > Add-on Store, add the repository https://github.com/Syracuse3DPrintingOrg/PantryRaider, install Pantry Raider, and start it. Install the communityGrocy add-on first — unlike the Docker paths, the add-on does not bundle the inventory backend; the setup wizard points Pantry Raider at it.

Already running Pantry Raider on another box? You want the separateHome Assistant integration instead: install it through HACS and pair with a code on the kitchen screen — live sensors, notifications, and camera pop-ups with no key pasting.

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

One auto-update switch covers the fleet: servers update through Watchtower, appliances over the air, and satellites follow their server's version.

Reach it from outside your kitchen

Out of the box the app serves plain HTTP on your LAN. For HTTPS or remote access, put your own reverse proxy — Caddy, nginx, Traefik, or Pangolin — in front of it to handle TLS, or turn on the built-in tunnel, which publishes the app over HTTPS without opening a port. The platforms guide covers both.

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. There is no monthly subscription for full-tier services when you self-host. Forager, the optional hosted companion, adds remote access and pooled AI from $10/year, and it is strictly optional.

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), weather forecasts from Open-Meteo (the panel can be turned off), recipe search from TheMealDB (your own library stays local), 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. 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?

Yes, after the initial install. First-time setup needs internet to pull the images, but from then on, with Ollama for AI and barcode enrichment disabled, day-to-day use, startup, and restarts all work with no internet access and no cloud dependency.

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 index links out to the documentation site for the longer guides.

Up and running in one command

A dedicated Raspberry Pi kitchen appliance, Docker Compose on any server or NAS, or a Home Assistant add-on.

Try the Demo See the hardware