Self-hosted recipe manager for storing recipes, planning meals, and generating shopping lists, with Docker installation.
- Stars
- 1,522
- Forks
- 134
- Open issues
- 84
- Last commit
- 2 days ago
What is it?
Norish is a self-hosted recipe manager built around the household: members can plan meals, share groceries, and cook together, with changes syncing in real time across devices.
The app runs as a Docker container alongside PostgreSQL, Redis, and an Obscura service that renders recipe pages when importing recipes from URLs. A MASTER_KEY derives the encryption keys used for stored data, so it must remain stable once set.
The project is written in TypeScript, licensed under AGPL-3.0, and includes a development setup guide for contributors.
Key features
- 01Real-time sync so household members see meal plan and grocery updates immediately
- 02Meal planning for shared weekly menus
- 03Shared grocery lists
- 04Recipe import from web page URLs
- 05Docker Compose deployment with PostgreSQL and Redis
Use cases
- Planning weekly family dinners and sharing the plan with everyone at home
- Keeping a shared grocery list that multiple people can edit
- Hosting a private recipe collection on your own server instead of a cloud service
Quick start
- 1
Generate a MASTER_KEY
openssl rand -base64 32 - 2
Save the README's Docker Compose file and replace the placeholder values (MASTER_KEY, OBSCURA_CDP_TOKEN)
- 3
Start the services with Docker Compose
Things to know
- Licensed under AGPL-3.0, a copyleft license that requires derivative network services to share their source code.
- Self-hosting needs several services: the app, PostgreSQL, Redis, and an Obscura renderer for URL imports.
In collections
Topics
FAQ
- What is norish?
- A real-time, self-hosted recipe app for households to plan meals, share grocery lists, and cook together. Norish is a self-hosted recipe manager built around the household: members can plan meals, share groceries, and cook together, with changes syncing in real time across devices.
- Is norish free to use? What license does it have?
- norish is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
- Is norish still maintained?
- Actively maintained. The last commit to norish was on Nov 5, 2026.
- What can I use norish for?
- Planning weekly family dinners and sharing the plan with everyone at home Keeping a shared grocery list that multiple people can edit Hosting a private recipe collection on your own server instead of a cloud service
- How do I install norish?
- Generate a MASTER_KEY: openssl rand -base64 32 Save the README's Docker Compose file and replace the placeholder values (MASTER_KEY, OBSCURA_CDP_TOKEN) Start the services with Docker Compose
- Where can I get norish?
- The source code and installation instructions are on GitHub: https://github.com/norish-recipes/norish
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A self-hosted recipe manager that imports recipes from URLs, converts units, scales ingredients and logs your cooking.
A self-hosted recipe manager web app for saving, importing, and organizing family recipes, written in Go.
A collaborative recipe keeper, meal planner, and shopping list organizer, delivered as a PWA that works offline and syncs across devices.
Self-hosted recipe manager and meal planner that imports recipes from URLs and builds shopping lists.
A self-hosted grocery list and recipe manager with native mobile, web and desktop apps and real-time sync between users.