opensourceprojects.dev

A broadsheet for software that doesn't ask for your email

Self-hosted recipe manager with meal planning, shopping lists, and URL imports
GitHub RepoImpressions4

Project Description

View on GitHub

Mealie: A Self-Hosted Recipe Manager That Actually Does the Meal Planning Part

You've got recipes saved in twelve different places. A few bookmarked in your browser, some screenshots buried in your camera roll, a couple of index cards your grandmother wrote out, and the rest scattered across whatever app you were using three phones ago. When it's time to figure out what to cook this week, none of it helps. Mealie is a self-hosted answer to that mess—a recipe manager, meal planner, and shopping list that keeps everything in one place you actually control.

What It Does

Mealie is a self-hosted recipe manager with a REST API backend and a reactive frontend built in Vue. The core idea is simple: you add recipes to your own database, then use them to plan meals and generate shopping lists. The most convenient way to add a recipe is by URL—paste a link, and Mealie automatically imports the relevant data. If that doesn't work (or you're adding a family recipe that only exists on a stained index card), there's a UI editor for entering things manually.

From there, the app branches into the parts that make it more than just a recipe box. The meal planner lets you sketch out what you'll cook over the coming week. The shopping list collects the necessary ingredients and organizes them into sections matching your local supermarket's layout—so you're not zigzagging across the store. Cookbooks let you group recipes by whatever criteria make sense to you, whether that's "weeknight dinners," "things my kid will eat," or "recipes I'll get around to someday."

Deployment is handled through Docker, and the interface has been translated into 35+ languages, which matters if your household doesn't operate in English.

Why It's Cool

The URL import is the feature that earns its keep. Let's be honest—manually entering recipes is tedious, and it's the reason most people abandon recipe apps within a month. Being able to paste a URL from a food blog and get something usable on the other end removes the main friction point. Mealie doesn't pretend manual entry isn't an option, but it clearly knows which one you'd rather use.

Meal planning and shopping lists are connected, not bolted on. Plenty of apps treat these as separate features that happen to live in the same interface. The value here is that planning a week of meals flows directly into a shopping list organized by supermarket section. That's the actual workflow people have, and it's nice to see it reflected in the design rather than treated as an afterthought.

It's genuinely self-hosted. Your recipes live on your hardware, accessible through a REST API that third-party applications can interact with. If you've been wanting to move away from subscription-based recipe apps or cloud services that might shut down or change their terms, this is a practical alternative. The AGPL license means it stays open.

Docker deployment keeps the barrier low. You don't need to be a sysadmin to get this running. If you've deployed a container before, you'll be fine.

Localization is taken seriously. 35+ languages is a lot of languages. It suggests the maintainers care about the project being usable beyond a single demographic—and that the translation workflow (they use Crowdin) is something non-coders can contribute to directly.

Cookbooks are a small but smart touch. Tags and categories are fine, but a cookbook feels like a collection you'd actually maintain. It's a more human way to organize recipes than a flat taxonomy.

How to Try It

The quickest path is Docker. The project publishes images to the GitHub Container Registry, so you can pull and run without building anything from source:

docker pull ghcr.io/mealie-recipes/mealie

From there, check the documentation for the full setup, configuration options, and environment variables. If you'd rather poke around before committing to a deployment, there's a live demo at demo.mealie.io.

If you want to run it from source or contribute to development, the repository is at github.com/mealie-recipes/mealie. Contributors are encouraged to use VSCode Dev Containers, which lowers the setup burden if you're new to the codebase. There's a contributors guide on the nightly docs site, and the project also accepts translations through Crowdin if you'd rather help without touching code.

Final Thoughts

Mealie is best suited for people who already self-host a few things and want their recipes to join the party—or anyone who's tired of recipe apps that lock their data behind a subscription. It's not trying to be a social network or a food blog platform; it's a tool for planning meals and buying groceries. If that's the problem you have, the combination of URL imports, a real meal planner, and a shopping list that reflects your actual supermarket makes a convincing case. The project is mature enough to be useful today, and active enough that it's still improving.

Back to Projects
Project ID: 54d832a1-e672-409a-98e0-da1aea359569Last updated: September 27, 2026 at 02:54 AM