KitchenOwl

KitchenOwl

Docker app from HanSolo97's Repository

Overview

KitchenOwl Backend Server. It's mandatory to also install the KitchenOwl-Web Container to access it from mobile and/or web. KitchenOwl is a self-hosted grocery list and recipe manager. The backend is made with Flask and the frontend with Flutter. Easily add items to your shopping list before you go shopping. You can also create recipes and add items based on what you want to cook.

KitchenOwl

A smart grocery list and recipe manager.

Website | Docs | Self-Hosting | Matrix

Stars Translation Matrix License GitHub release (latest by date) Docker pulls

🍫 πŸ₯˜ 🍽

KitchenOwl is a smart self-hosted grocery list and recipe manager. Easily add items to your shopping list before you go shopping. You can also create recipes and get suggestions on what you want to cook. Track your expenses so you know how much you've spent.

  • Native Mobile/Web/Desktop apps with a great design
  • Add items to your shopping list and sync them in real-time with multiple users
  • Partial offline support, so you don't lose track of what to buy even when there is no signal
  • Manage recipes and add them to your shopping list
  • Share recipes with friends and family
  • Create a meal plan to always know what you'll be eating
  • Manage balances and track expenses of your household

Please keep in mind that this project is still in development.

For a full list check out the website. For a list of planned features, take a look at the Roadmap!

πŸ“± Screenshots

Groceries page Recipe page Plan page Expense page

πŸ€– App Install

Get it in your favorite store or find the current release for your operating system on the releases page.

πŸš€ Get started

Please take a look at the get started guide.

πŸ™Œ Contributing

From opening a bug report to creating a pull request: every contribution is appreciated and welcomed. If you're planning to implement a new feature or change the API please create an issue first. This way, we can ensure your work is not in vain. For more information see Contributing or get in contact by joining our Matrix space.

🌍 Translations

You can help translate the App into your language by using Weblate!

Translation status

πŸ›ŽοΈ Stay Up-to-Date

KitchenOwl is moving fast, to stay updated consider starring and watching the releases of this repository.

πŸ’¬ Status

  • Public Alpha: Still working on stuff (rarely things might break)
  • Public Beta: Stable and most planned features complete
  • Public: Production-ready

πŸ“š Related

πŸ”¨ Built With

πŸ€ Contributors

πŸ“œ License

KitchenOwl is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the AGPL-3.0 License.

Install KitchenOwl on Unraid in a few clicks.

Find KitchenOwl in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for KitchenOwl Review the template variables and paths Click Install

Categories

Download Statistics

1,164,343
Total Downloads
116,743
This Month
72,783
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
tombursch/kitchenowl
Last Updated2026-06-28
First Seen2022-01-22

Runtime arguments

Network
bridge
Privileged
false

Template configuration

Path /dataPathrw

This is where the KitchenOwl Database is stored.

Target
/data
Default
/mnt/user/appdata/kitchenowl
Value
/mnt/user/appdata/kitchenowl
KitchenOwl ServicePorttcp

KitchenOwl Service Port

Target
5000
Default
5000
Value
5000
Url for the Web Frontend (needs kitchenowl-web container)Variable

Url for the Web Frontend (needs additional kitchenowl-web container)

Target
FRONT_URL
Default
http://localhost:8123
Value
http://localhost:8123
JWT Secret (CHANGE THIS!)Variable

For security reasons, it is mandatory to change the JWT Secret! Preferably use a secure random key generator for that.

Target
JWT_SECRET_KEY
Default
PLEASE_CHANGE_ME
Value
PLEASE_CHANGE_ME