Mealie Setup Guide - ajgillis04/GillisDockerDepot GitHub Wiki

Mealie Setup Guide

Introduction

Mealie is a self-hosted recipe manager. Paste a link from a recipe website and it imports the recipe; it also does meal plans, shopping lists, scaling by servings, and (optionally) recipes from photos or videos using AI. In this repository it replaced Chowdown.

Step 1: Compose

compose/server1/mealie.yaml:

services:
  mealie:
    container_name: mealie.${HOST_NAME}
    image: ghcr.io/mealie-recipes/mealie:latest
    environment:
      PUID: ${PUID}
      PGID: ${PGID}
      TZ: ${TZ}
      ALLOW_SIGNUP: "false"
      BASE_URL: https://mealie.${DOMAINNAME}
      MAX_WORKERS: 1
      WEB_CONCURRENCY: 1
    ports:
      - "${MEALIE_PORT}:9000"
    volumes:
      - ${DOCKERDIR}/mealie/data:/app/data
    deploy:
      resources:
        limits:
          memory: 1000M
    restart: unless-stopped
    labels:
      - "com.centurylinklabs.watchtower.enable=true"

Everything (database, images, backups) is in appdata/mealie/data.

Step 2: First Login

Open http://<server-ip>:<MEALIE_PORT>. The first start opens a setup wizard. If you skip it, the default admin login is [email protected] / MyPassword. Change both straight away, especially before exposing Mealie outside your network.

Step 3: Set Up the Basics

  • Load the starter data (Settings → Data Management): the built-in lists of foods, units and labels (grocery aisles). Mealie needs these to understand ingredient lines ("2 cups flour" → amount, unit, food), which is what makes scaling and shopping lists work.
  • Categories for courses (Breakfast, Mains, Sides, Soups & Stews, Desserts & Baking, Drinks…), tags for main ingredient, cuisine and occasion, and tools (Instant Pot, Slow Cooker, Grill…).
  • Cookbooks are saved views (for example "all recipes in the Desserts category") that appear in the sidebar. They're the easiest way for family to browse.

Mealie cookbook view

Once ingredients are parsed into amount, unit and food, the Serves buttons scale the recipe and ingredients can be sent to a shopping list:

Mealie recipe view

Step 4: Let Family View Recipes Without an Account

By default everything is private. To let people read recipes without logging in:

  1. Group settings: turn off Private Group.
  2. Household settings: turn off Private Household and turn on Allow users outside of your group to see your recipes.
  3. Each recipe has its own Public switch. New recipes follow the household default.

The public recipe page is https://mealie.example.com/g/<group-slug> (the default group is home). The plain front page still goes to the login screen, so share the /g/home link. Editing still needs an account. If Mealie sits behind Cloudflare Access: Zero Trust, visitors must pass that first.

Step 5 (Optional): AI Features

Under Group settings → AI Providers you can connect any OpenAI-compatible service, including a local Ollama Setup Guide:

Role Example What it enables
Default provider Ollama, base URL http://<ollama-host>:11434/v1, a vision-capable model such as gemma4:e4b, any API key text AI ingredient parsing, importing from messy websites
Image provider same model Create recipe from a photo (a recipe card or cookbook page)
Audio provider an OpenAI-style speech-to-text server such as Speaches Setup Guide, model Systran/faster-distil-whisper-small.en Import from a video (YouTube, TikTok, Instagram)

Use the Test button on each provider. A speech-to-text-only provider fails the test until it's assigned as the audio provider; after that, Mealie tests it by transcribing instead.

The AI ingredient parser is good but can drop alternatives: "Ranch or blue cheese dressing" may come back as just "dressing". Mealie keeps the original text alongside, but review lines with "or" before saving.

Moving from Chowdown

Chowdown recipes are Markdown files with YAML front matter (title, image, tags, ingredients, directions), plus an images/ folder. A short script can import them through Mealie's API:

  1. Create each recipe with POST /api/recipes, then PUT the full recipe (ingredients as notes, steps, tags).
  2. Upload the photo with PUT /api/recipes/<slug>/image. Very large photos (100+ megapixels) are rejected; shrink them first.
  3. Bold lines such as __Sauce:__ map nicely to Mealie's section titles.
  4. Chowdown ships three sample "components" (graham cracker crust, red berry topping, vanilla custard); leave them out.

Watch out: after import, Mealie may split some lines into amount/unit/food and leave only fragments in the visible note (for example "tbls packed"). The full line is kept in the ingredient's original text, so nothing is lost; re-parse from that field.

To keep an old Chowdown address working, point it at a tiny redirect instead of Chowdown. This repository uses compose/server1/chowdown-redirect.yaml, an nginx:stable-alpine container whose config returns a 301 to https://mealie.example.com/g/home.

Backups and Updates

  • Mealie makes its own backups (Settings → Backups), saved in appdata/mealie/data/backups. Copy the data folder before big changes.
  • Watchtower keeps it updated monthly.
⚠️ **GitHub.com Fallback** ⚠️