---
title: mealie Stack
description: Mealie recipe manager
published: true
date: 2026-04-24T04:48:34.567Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-24T04:48:34.567Z
---

# mealie

## Overview
The mealie stack provides a recipe manager service for NetGrimoire. It consists of the mealie service, which is responsible for managing recipes and providing a user-friendly interface.

## Architecture
| Service | Image | Port | Role |
|---------|-----|-----|-------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com, Internal only
- **Homepage group:** PNCHarris Apps

---
## Build & Configuration

### Prerequisites
Ensure you have the necessary Docker and Caddy configurations in place.

### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie
```

### Environment Variables
```bash
# generate: openssl rand -hex 32
PUID=1964
PGID=1964
TZ=America/Chicago
MAX_WORKERS=1
WEB_CONCURRENCY=1
BASE_URL=https://recipe.netgrimoire.com
ALLOW_PASSWORD_LOGIN=false
ALLOW_SIGNUP=false
OIDC_AUTH_ENABLED=true
OIDC_PROVIDER_NAME=authentik
OIDC_CONFIGURATION_URL=https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration
OIDC_CLIENT_ID=tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz
OIDC_CLIENT_SECRET=OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK
OIDC_AUTO_REDIRECT=true
OIDC_REMEMBER_ME=true
OIDC_SIGNUP_ENABLED=true
OIDC_USER_CLAIM=sub
OIDC_NAME_CLAIM=preferred_username
OIDC_GROUPS_CLAIM=groups
OIDC_SCOPES_OVERRIDE=openid profile email
OIDC_USER_GROUP=mealie-users
OIDC_ADMIN_GROUP=mealie-admins
```

### Deploy
```bash
cd services/swarm/stack/mealie
set -a && source .env && set +a
docker stack config --compose-file mealie-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml mealie
rm resolved.yml
docker stack services mealie
```

### First Run
No specific steps required for a first run.

---
## User Guide

### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
- recipe.netgrimoire.com

### Primary Use Cases
Access the recipe manager service to manage recipes and provide a user-friendly interface.

### NetGrimoire Integrations
This service connects to authentik for OIDC authentication.

---
## Operations

### Monitoring
```bash
docker stack services mealie
docker service logs -f mealie
```

### Backups
Critical: Regular backups of the recipe data are necessary. The /DockerVol/mealie directory should be backed up regularly.
Reconstructable: The configuration files can be rebuilt from the Docker Stack.

### Restore
```bash
cd services/swarm/stack/mealie
./deploy.sh
```

---
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|------|
- Service not accessible | Caddy not running | Restart caddy service |
- Recipe data lost | Regular backups not executed | Execute regular backup routine |
- Config file corrupted | Incorrect config file version | Update config file to latest version |
- OIDC authentication issues | authentik configuration incorrect | Review and update authentik configuration |
- Recipe management errors | Mealie configuration incorrect | Review and update mealie configuration |

---
## Changelog

| Date | Commit | Summary |
|------|--------|---------|
- 2026-04-23 | c58c7bc2 | Initial documentation creation |
| 2026-04-23 | 8fbdfbec | Update Caddy reverse proxy label |
| 2026-04-23 | 1cc32c85 | Update homepage description |
| 2026-04-23 | f00d649e | Update NetGrimoire integrations section |
| 2026-04-23 | 824ed13e | Update common failures section |

<Generated by Gremlin on 2026-04-24T04:48:34.567Z>
<Source: swarm/mealie.yaml>
<Review User Guide and Changelog sections>