---
title: mealie Stack
description: Mealie Recipe Manager Stack
published: true
date: 2026-04-29T20:07:54.830Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-29T20:07:54.830Z
---

# mealie

## Overview
The mealie stack is a Docker Swarm-based recipe manager service in NetGrimoire. It provides a web interface for users to create, manage, and share recipes. The service includes mealie-recipes, which are served via Caddy's reverse proxy.

## Architecture
| Service | Image | Port | Role |
|---------|-----|-----|---------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com: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 1001:1001 /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 the service, you may need to update your Caddy configuration to include the new service.

---

## User Guide

### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
- **mealie**: https://recipe.netgrimoire.com:9000 (only accessible via Caddy's reverse proxy)

### Primary Use Cases
To use this service, follow these steps:
1. Log in to the mealie interface using your credentials.
2. Create or edit recipes as needed.

### NetGrimoire Integrations
This service connects to other services in NetGrimoire through environment variables and labels.

---

## Operations

### Monitoring
[kuma monitors from kuma.* labels]
```bash
docker stack services mealie
docker service logs -f mealie
```

### Backups
Critical data is stored on the /DockerVol/mealie volume. Regular backups are not available, but you can use Docker's built-in snapshot feature to create a full backup of the container.

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

---

## Common Failures
1. **Symptom:** The mealie interface is unresponsive.
**Cause:** The service may be down or experiencing issues with its Caddy reverse proxy configuration.
**Fix:** Check the Caddy logs for any errors and restart the service.

2. **Symptom:** No recipes are being created.
**Cause:** The user does not have permission to create recipes.
**Fix:** Ensure that the user has the necessary permissions by checking their role in the mealie-users group.

3. **Symptom:** Recipes are not syncing between nodes.
**Cause:** The service relies on Caddy's reverse proxy configuration, which may be causing issues with node connections.
**Fix:** Check the Caddy logs for any errors and restart the service.

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-29 | ebbea734 | Initial documentation created by Gremlin on 2026-04-29T20:07:54.830Z |
| 2026-04-29 | 78a2ca11 | Updated Caddy labels for mealie service |
| 2026-04-28 | f62e2f0b | Added environment variables to the mealie service |
| 2026-04-28 | 1637c0bd | Fixed bug in Caddy reverse proxy configuration |

---

## Notes
- Generated by Gremlin on 2026-04-29T20:07:54.830Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections