A quick health check of this device and the services it talks to. Green is healthy, amber needs a look, red is a problem. Refresh

Live readings from this device: processor, memory, storage, temperature. Updates every few seconds while this page is open.

Built-in live snapshot, always available on this device:

Where your stock lives: the Grocy backend and the storage buckets it's grouped into.

How items get into the pantry: the barcode scanner, barcode enrichment, and the AI models that read your food photos and receipts.

Barcode scanner

A USB, Bluetooth, or camera scanner for adding and consuming items.

Scanner type

Which method to reach for first.

Not set (pick on Manage Pantry page) USB / Bluetooth HID (keyboard wedge) Camera / built-in scan module

Scan from any page

Capture a scan on any screen.

Set up a scan-engine reader

Program it off the screen with a guided wizard.

Open scanner setup wizard

Scan to run it on a phone.

Test the scanner

Plug it in, click, and scan.

Running a Waveshare scan-engine module on a kiosk? See the hands-free setup codes to make it scan on sight without the button.

Camera scanning runs in the browser, so make sure this site has camera permission.

Your optional Forager account: sign in for hands-off photo, receipt, and barcode scanning, see your plan and usage, and turn on remote access so you can reach your kitchen from anywhere. What Forager stores and what stays home is spelled out in the privacy policy.

Your recipe library and its connections: where recipes are stored, an optional Mealie hookup, and where "What can I cook?" looks for extra ideas. How suggestions get ranked against your tastes and kitchen lives under Recipe suggestions.

Mealie is optional. Most kitchens use the built-in recipe library and never need it.

Your tastes and kitchen: how "What can I cook?" ranks recipes against your pantry, preferences, and the tools you own. These are personal settings; the Mealie connection and recipe sources live under Recipes.

How the app looks everywhere: the colour theme, an optional background photo, and which pages appear in the navigation.

Camera feeds for the on-screen Camera page and, when a Stream Deck is connected, a snapshot key or the full-deck overlay. The "add from your phone" QR code is set here too.

Connect Home Assistant to power the Stream Deck Home Assistant keys, camera discovery, and on-screen notifications. The easiest way is the Pantry Raider integration inside Home Assistant, which sets this page up for you. Home Assistant is optional: everything else works without it.

rest_command:
  foodassistant_notify:
    url: "http://THIS-DEVICE:9284/events/notify"
    method: POST
    headers:
      X-API-Key: "YOUR_FOODASSISTANT_API_KEY"
    content_type: "application/json"
    payload: '{"title":"","message":"","level":""}'
  foodassistant_camera_popup:
    url: "http://THIS-DEVICE:9284/events/camera-popup"
    method: POST
    headers:
      X-API-Key: "YOUR_FOODASSISTANT_API_KEY"
    content_type: "application/json"
    payload: '{"camera":"","seconds":}'
  foodassistant_camera_detect:
    url: "http://THIS-DEVICE:9284/events/camera-detect"
    method: POST
    headers:
      X-API-Key: "YOUR_FOODASSISTANT_API_KEY"
    content_type: "application/json"
    payload: '{"camera":"","detection_type":""}'

automation:
  - alias: "Person at door -> pop up camera"
    trigger:
      - platform: state
        entity_id: binary_sensor.front_door_person
        to: "on"
    action:
      - service: rest_command.foodassistant_camera_popup
        data:
          camera: "Front Door"
          seconds: 20

automation:
  - alias: "Front door detection -> maybe pop up camera"
    trigger:
      - platform: state
        entity_id: sensor.front_door_detection_type
    action:
      - service: rest_command.foodassistant_camera_detect
        data:
          camera: "Front Door"
          detection_type: "{{ trigger.to_state.state }}"

This device's connection: Wi-Fi and Ethernet, its network name, and the attached hardware it can see.

Who can reach the app and how login is protected.

Authentication

How people sign in to this app.

Off

Require a password

Ask for a password to use the app.

Password

The main login password.

Not set Set password

New password

Confirm new password

Required while authentication is on. The app will not finish setup without it.

Kitchen access

An optional second, limited password.

Optional Set a password

Two-factor

A code from an authenticator app.

Off Set up 2FA

Scan with your authenticator app, then enter the code to confirm.

Enable

Print food and spice labels, and full recipes, on any printer shared on your network. A printer attached to one device is usable from every device.

Label size

The size of your label stock, in inches, plus its print resolution. The preview updates as you change these.

Label stock

A common format, or your own size in inches.

Format Custom size

Shape Rectangle Square Round

Width

Height

Resolution (DPI)

Use a size my printer supports

Preview

A sample label at the size above.

Show logo

Design your label

Place the fields on your label and see the printed result as you go. Your saved design is used for every food label; the size above sets the stock it prints on.

Turn printing on above to design your label.

Layout (drag to move, drag a corner to resize)

Printed result

Add a field

Field Delete

Text

Align

Text size

Symbol

QR content URL / text Plain text Contact card (vCard)

Note (optional)

Bold UPPERCASE Outline / border

Saved designs

Choose a saved design… Load Delete Save as…

Save layout Reset to default

Your saved design applies to every printed food label.

Decorative labels

Make a plain name label for a spice jar, canister, or storage bin. No dates, just the text.

Label

Type the text and print; the preview updates as you go.

Text

Symbol No symbol

Outline

Print label

Bluetooth and WiFi sensors around the kitchen: cooking probes, fridge and room sensors, door sensors, and shelf buttons. Readings stay on your own network; no cloud account is involved.

Keep the app up to date, and save your data off-box.

docker compose pull
docker compose up -d

Maintenance that is not day-to-day: the timezone, reloads and reboots, diagnostics, and switching this device's role.

Bandit remotes and other satellite displays that follow this server.

An optional full-screen launcher that works like an on-screen Stream Deck. It opens at /ui/start and replaces the fixed and floating menus while shown. With Start at the top of the navigation menu it becomes this device's home screen.

How the app behaves on a screen: the on-screen navigation bar and quiet mode. Panel, sleep, and screensaver settings appear here on a device with an attached display.