Home & auto
KitchenOwl
Shared grocery lists, recipes and meal planning for a household.
Release notes / v0.8.1
Released 2026-11-08. Snapshot from the included release data, not a live check.
It's been a short while, but this release packs many bug fixes and improvements with many new faces who contributed! For self-hosters: We're migrating to rootless Docker images. The entrypoint should take care of the migration so no manual change is required, but it's something to be aware of if you're using a very custom setup. ## ✨ Features - Add household currency setting (#1207 by @TomBursch) - Add AI recipe generator chat (#1160 by @vanalmsick) - Show longer ingredient names in recipe ingredient cards (#1103 by @Percy2Live) - Open URL from item description on long press (#1132 by @xoiram) - Sort and search shopping list items, ignoring diacritics (#1172 by @paulmiddelkoop) - Environment option to default to NLP for English recipes even when LLM is enabled (#1133 by @wh1t3-…
Read the full release notes on GitHub ↗Available on these platforms
Requires a self-hosted KitchenOwl server.
Server systems, compatibility details and official sources
These are clients for the KitchenOwl service.
The current release has Linux, Windows, macOS, Android and Web artifacts, and the project documents iOS.
- Linux (server) - Docker (documented self-hosting route)
- Linux (client) - Native client
- Windows (client) - Native client
- macOS (client) - Native client
- Android (client) - Native client
- iOS (client) - Native mobile client
- Web (client) - Browser client
Official availability checked 2026-11-12. Availability is not feature parity. The recorded release and license refer to the linked source project; separate clients can differ. No install or compatibility test was run.
Before you install
Shopping lists and recipes for a household.
- What does it run on?
- A server you host with web and mobile clients against it. Built for a household, not a team wiki.
- Where is my data?
- Lists, recipes and meal plans live on your server.
- What will I maintain?
- Updates and a backup. Note that upstream still labels the project public alpha, not production-ready - expect rough edges.
Advice and funding routes source-checked November 12, 2026. Researched, not an install or restore test. Installation source ↗ · Report a correction

KitchenOwl combines shared shopping lists, recipes and meal planning. It is built for a household rather than a team wiki: add ingredients to a list, keep recipes together and use web or mobile clients against your own server.
Upstream still labels the project public alpha, not production-ready, and warns that things can occasionally break. Keep exports and backups and try it with a non-critical list before relying on it for the household.
Quick start
Checked against the official single-container example on November 9, 2026.
Docker Compose
Requires Docker and the Compose plugin. Create a private .env file with
KITCHENOWL_JWT_SECRET= followed by a long, unique random secret. Run
chmod 600 .env and keep it out of version control. Do not use upstream’s
placeholder secret. Save this as compose.yaml:
services:
kitchenowl:
image: tombursch/kitchenowl:latest
ports:
- "127.0.0.1:8080:8080"
environment:
JWT_SECRET_KEY: ${KITCHENOWL_JWT_SECRET:?Set it in .env first}
volumes:
- kitchenowl-data:/data
restart: unless-stopped
volumes:
kitchenowl-data:
Run docker compose up -d, then open http://localhost:8080 on the host and
complete the initial setup. The single image serves the web client and
backend. Back up the kitchenowl-data volume and preserve the secret.
This port is intentionally local. Mobile clients need a reachable server URL; follow the official self-hosting guide to set up remote access with HTTPS before connecting them. Review release notes and back up before updates, especially while the project is in alpha.
Docker Compose · Shared grocery lists, recipes and meal planning for a household. Paste into your AI assistant. It may only be able to guide you. Review changes before running anything.
Researched from the project's documentation. Checked 2026-11-12. No AI account or connection is needed here.
Read or copy the prompt manually
Why it’s listed
A practical household use for self-hosting that is different from managing servers or media libraries. Its shared list and recipe workflow is worth trying, with its alpha status kept in view.
Documentation
Tags: Home, Self-hosted
Want help setting this up? Ask FOSSadmin ↗