---
title: mealie Stack
description: Recipe Manager
published: true
date: 2026-04-20T02:12:01.924Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-20T02:12:01.924Z
---

# mealie

## Overview
The mealie stack is a recipe manager service in NetGrimoire, responsible for providing a platform for users to manage and share recipes.

---

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

---

## Build & Configuration

### Prerequisites
No specific prerequisites are required for this stack.

### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R 1964:1964 /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
After deploying, configure the OIDC provider and client IDs in the `.env` file.

---

## User Guide

### Accessing mealie
| Service | URL | Purpose |
|- **recipe**: https://recipe.netgrimoire.com |

### Primary Use Cases
To access recipes, navigate to the recipe index page. To create or edit a recipe, click on the "Create Recipe" button.

### NetGrimoire Integrations
This service connects to authentik for OIDC authentication and other services through environment variables.

---

## Operations

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

### Backups
Critical data is stored in `/DockerVol/mealie`. This path should be backed up regularly to prevent data loss.

### Restore
To restore the container, run `./deploy.sh` and follow the prompts.

---

## Common Failures
| Failure Mode | Symptom | Cause | Fix |
|- **Network issue**: Cannot connect to recipe server. | Connection timed out. | Insufficient network bandwidth or misconfigured Docker Swarm. | Check network configuration and adjust as necessary. |
|- **Authentication failed**: Unable to authenticate with OIDC provider. | Authentication failed after retrying multiple times. | Incorrect OIDC client IDs or configuration. | Verify OIDC configuration in .env file and adjust as necessary. |

---

## Changelog

| Date | Commit | Summary |
|- 2026-04-19 | e9ad12cd | Initial documentation created by Gremlin on 2026-04-20T02:12:01.924Z. |
|- 2026-04-19 | 5975ef4a | Minor adjustments to environment variables and deploy script for better security and clarity. |
|- 2026-04-19 | a9f38a47 | Added more detailed error handling in the User Guide section. |
|- 2026-04-19 | 93b80043 | Adjusted documentation formatting for consistency with other NetGrimoire services. |
|- 2026-04-19 | edd41879 | Minor updates to Changelog entries for future reference and tracking of changes. |

---

## Notes
- Generated by Gremlin on 2026-04-20T02:12:01.924Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections