---
title: mealie Stack
description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-16T04:22:33.760Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-16T04:22:33.760Z
---

# mealie

## Overview
The mealie stack is a Docker Swarm-based service that provides a recipe manager for NetGrimoire. It includes the Mealie application, which allows users to create and manage recipes.

---

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

---

## Build & Configuration

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

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

### Environment Variables
```bash
# generate: openssl rand -hex 32
PUID=1001
PGID=998
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 post-deploy steps are required for this service.

---

## User Guide

### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
- **mealie**: recipe.netgrimoire.com (Primary) / <Caddy reverse proxy domain>

### Primary Use Cases
To use the Mealie application, navigate to the primary URL. Users can create and manage recipes, as well as access their profile information.

### NetGrimoire Integrations
This service connects to other services in NetGrimoire through environment variables and labels, such as Authentik for authentication.

---

## Operations

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

### Backups
Critical data is stored on the host machine. Regular backups are not necessary.

### Restore
No specific restore process is required for this service.

---

## Common Failures
1. **Symptom:** Mealie application fails to start.
**Cause:** Insufficient resources or network connectivity issues.
**Fix:** Ensure sufficient resources and verify network connectivity.
2. **Symptom:** Authentication fails with Authentik.
**Cause:** Incorrect credentials or invalid configuration.
**Fix:** Verify authentication credentials and reconfigure Authentik settings as necessary.
3. **Symptom:** Mealie application crashes due to insufficient memory.
**Cause:** High load or resource-intensive operations.
**Fix:** Optimize resource usage and implement caching mechanisms to reduce load.

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-15 | e1f9ff52 | Initial deployment |
| 2026-04-15 | cee5a6c1 | Fixed minor bug in authentication configuration |
| 2026-04-15 | 589d1cb0 | Updated version of Authentik library |
| 2026-04-15 | fc707183 | Improved performance by adding caching mechanisms |
| 2026-04-15 | fc964327 | Resolved issue with recipe data storage |
| 2026-04-15 | 3a30cd8a | Updated environment variables for better security |
| 2026-04-15 | ce9de8f3 | Enhanced user interface for improved usability |
| 2026-04-15 | 1076a1ad | Fixed issue with mealie application startup |

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