ansible-infra/roles/kitchenowl/README.md
2025-08-15 15:56:57 +02:00

1.7 KiB

Ansible Kitchenowl deployment with docker

Introduction

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

Checkout more: https://github.com/tombursch/kitchenowl

Why docker

Whilst I try to refrain from using docker, especially together with ansible, it is the recommended way of installation: https://docs.kitchenowl.org/latest/self-hosting/ .

One could also decide to build from source, but I fear that the chance of brakage is higher than just using docker.

Notice

This role does not care about creating a rootless docker installation and should primarily used inside a vm.

Checkout https://docs.docker.com/engine/security/rootless/ or https://wiki.archlinux.org/title/Docker#Rootless_Docker_daemon for more information on rootless docker.

Variables

See defaults for needed variables.

OIDC

OIDC can be used as decribed in https://docs.kitchenowl.org/latest/self-hosting/oidc/ by enabling kitchenowl_oidc and using the respected variables.

Secrets

Please use secrets as described in README#Secrets