---
title: mealie Stack
description: Mealie recipe management platform in NetGrimoire
published: true
date: 2026-04-28T20:04:22.946Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-28T20:04:22.946Z

---

# mealie

## Overview
The mealie Stack provides a recipe management platform in NetGrimoire, enabling users to manage and share recipes across the community. It is composed of a single service that runs on docker4, utilizing the netgrimoire overlay network.

---

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

---

## Build & Configuration

### Prerequisites
Ensure Docker and Caddy are installed on the cluster.

### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R docker4:docker4 /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 initial deployment, the service should be accessible at recipe.netgrimoire.com. Users can log in with their credentials and start managing recipes.

---

## User Guide

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

### Primary Use Cases
To use this service, users should be familiar with recipe management platforms. They can create and share recipes, manage their own profiles, and engage with the community.

### NetGrimoire Integrations
This service integrates with other services in NetGrimoire, such as authentik for user authentication and monitoring tools like Uptime Kuma to ensure platform availability.

---

## Operations

### Monitoring
- `kuma.*`: Ensure Uptime Kuma is installed on the cluster.
```bash
docker stack services mealie
docker service logs -f mealie
```

### Backups
Critical data stored in /DockerVol/mealie. Regular backups are essential to ensure business continuity.

### Restore
To restore the service, re-run the deploy script.
```bash
cd services/swarm/stack/mealie
./deploy.sh
```

---

## Common Failures
| Failure Mode | Symptoms | Cause | Fix |
|-------------|----------|------|-----|
| 1. Service Not Accessible | Error message when accessing recipe.netgrimoire.com | Caddy configuration issue or Docker service not running | Check caddy logs and ensure the Docker service is up and running |
| 2. User Authentication Issues | Unable to log in with credentials | OIDC configuration issue or Authentik integration problem | Review OIDC configuration and verify Authentik connection |
| 3. Service Not Deploying | Error message during deploy process | Docker swarm configuration issue or service not found | Check docker stack config file for errors and ensure the service exists in the swarm |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-28 | f62e2f0b | Initial deployment of mealie Stack in NetGrimoire |
| 2026-04-28 | 1637c0bd | Fixed issue with recipe.netgrimoire.com accessibility |

<Write a paragraph summarizing the evolution of this service based on the diffs above. If no diffs available, note that this is the initial documentation.>

---

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