# Mealie

> A self-hosted recipe manager, meal planner and shopping list.

- Page: https://cgt.octabyte.io/templates/mealie/
- Category: Home & family
- Replaces: Paprika and Plan to Eat
- Ease of use: Easy. Sign in with the admin email you entered at setup and the password Cloudgate created, then add recipes or invite your household.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: AGPL-3.0-only
- Good for: Households who want recipes, meal plans and shopping lists in one shared app
- Official website: https://mealie.io
- Documentation: https://docs.mealie.io
- Source code: https://github.com/mealie-recipes/mealie
- Last updated: 2026-11-20

## What is Mealie?

Mealie is a self-hosted recipe manager and meal planner: save recipes from any website, plan the week's meals and share one shopping list.

Mealie is a free, open-source, self-hosted recipe manager and meal planner that keeps your recipes, the week's meal plan and your shopping list in one app the whole household shares, in place of paid apps such as Paprika or Plan to Eat. Paste a recipe's web address and Mealie copies the ingredients and steps for you, or type in a family recipe by hand.

From there you plan meals on a calendar and send the ingredients to a shopping list sorted by supermarket section. Three flatmates sharing a kitchen, for example, could save their favourite recipes in one place, take turns filling in the week's dinners, and each tick items off the same list at the shop.

Mealie runs in any browser and can be added to a phone's home screen; there is no app in the app stores. It imports collections from Paprika, Plan to Eat and other recipe apps, and can use an AI provider you connect to read recipes from photos or videos.

Cloudgate installs Mealie on a server Cloudgate provides or one you connect, together with its database, and gives it a secure web address. Sign in with the admin email you entered at setup and the password Cloudgate created, then invite your household.

## What you can do with Mealie

- **Save recipes from any website**: Paste a recipe's web address and Mealie copies the ingredients, steps and times into your collection, or type in a family recipe yourself.
- **Plan the week's meals**: Fill a calendar with breakfasts, lunches, dinners and snacks, or let Mealie pick recipes for you by tag or category.
- **Build a shopping list in one click**: Add a recipe's or a whole day's ingredients to a shared list, sorted by supermarket section, and tick items off as you shop.
- **Keep recipes in order**: Sort recipes with categories, tags and cookbooks, search them, mark favourites and scale servings up or down.
- **Bring your recipes with you**: Import your collection from Paprika, Plan to Eat, Tandoor, Nextcloud Cookbook, Recipe Keeper, Copy Me That and other apps.
- **Share with your household**: Invite family or housemates by link; recipes are shared, and each household can keep its own meal plan and shopping lists.
- **Import with AI if you want it**: Connect your own AI provider to turn a photo of a handwritten recipe, pasted text or a cooking video into a recipe.

## Replaces Paprika and Plan to Eat

Mealie does the same job as Paprika and Plan to Eat. Here is what changes when you switch.

### What you gain

- Free, with no subscription and no paid tier
- One shared collection for the whole household, in any browser
- Your recipes and meal plans stay on your own server
- Brings over your recipes from Paprika or Plan to Eat

### What is different

- No phone or tablet app from the store; you add Mealie to your home screen from the browser instead
- No offline mode, so you need a connection to reach your recipes
- Some recipe websites can't be imported automatically, and the AI fallback needs a provider you pay for

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=mealie

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. Mealie itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up Mealie.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is Mealie free?

Yes, Mealie is free and open source under the AGPL-3.0 licence, with no paid edition. You pay only for your server, plus your AI provider if you choose to turn on the AI features.

### Is Mealie a good alternative to Paprika?

Yes, if you want one recipe collection the whole household shares, free, on your own server. Paprika has polished store apps that work offline; Mealie runs in the browser and can be added to a phone's home screen, but has no offline mode.

### Can I import my recipes from Paprika or Plan to Eat?

Yes, Mealie has importers for Paprika, Plan to Eat, Tandoor, Nextcloud Cookbook, Chowdown, Recipe Keeper, Copy Me That, My Recipe Box and DVO Cook'n X3. Export your recipes from the old app, then upload the file in Mealie.

### How do I sign in to Mealie the first time?

Sign in with the admin email you entered during setup and the password Cloudgate created for it, shown on the app's variables page. Mealie's well-known default login is replaced at first start, so it never works on your server.

### Is there a Mealie app for iPhone or Android?

No, Mealie has no official app in the App Store or Google Play. Open your Mealie address in the phone's browser and add it to the home screen, and it opens like an app.

### Can other people sign up to my Mealie?

No, not unless you allow it. Sign-ups are off by default, and you add family or housemates with invitation links from Mealie; you can turn open sign-ups on during setup.

### Does Mealie need an AI subscription?

No, Mealie works fully without AI. The optional AI import, from photos, text or videos, needs your own account with an OpenAI-compatible provider such as OpenAI or a local Ollama, and you pay that provider for what you use.

### Do I need technical skills to run Mealie?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up Mealie and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for Mealie?

No. When you deploy Mealie, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
