Netgrimoire/Netgrimoire/Services/mealie/mealie.md

title	description	published	date	tags	editor	dateCreated
mealie Stack	Recipe Manager	true	2026-04-23T22:53:56.270Z	docker,swarm,mealie,netgrimoire	markdown	2026-04-23T22:53:56.270Z

mealie

Overview

The mealie Stack is a Docker Swarm configuration for the mealie service in NetGrimoire, providing a recipe manager platform. It includes the main services such as Caddy reverse proxy and Uptime Kuma monitoring.

---

Services Table

Service	Image	Port	Role

• Host: docker4
• Network: netgrimoire

---

Architecture

Exposed via: recipe.netgrimoire.com, recipe:9000 Homepage group: PNCHarris Apps

---

Prerequisites

No specific prerequisites for this stack.

---

Volume Setup

mkdir -p /DockerVol/mealie:/app/data
chown -R 1981:1981 /DockerVol/mealie

Environment Variables

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

generate: openssl rand -hex 32

Deploy

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 for this service.

---

User Guide

Accessing mealie

| Service | URL | Purpose |

• Caddy Reverse Proxy: recipe.netgrimoire.com, recipe:9000

Primary Use Cases

To access the recipe manager platform and use its features such as recipe management and authentication.

NetGrimoire Integrations

Connects to other services in NetGrimoire through environment variables and labels.

---

Operations

Monitoring

kuma.* monitors from kuma.*

docker stack services mealie
docker service logs -f mealie

Backups

Critical vs reconstructable /DockerVol/ paths. This section requires more information on backup strategy and recovery processes.

Restore

cd services/swarm/stack/mealie
./deploy.sh

---

Common Failures

Failure Mode	Symptom	Cause	Fix

1. Caddy Error | No reverse proxy | Insufficient configuration or connection issues | Check and correct caddy configuration and ensure network connectivity.
2. Mealie Crash | Service crashes | High CPU usage or memory leaks | Monitor system resources and optimize service configuration.
3. Network Issues | Connection dropped| Network failure or misconfiguration | Verify network configuration and check for any issues with Docker Swarm networking.

---

Changelog

Date	Commit	Summary
2026-04-23	dcbfef14	Initial documentation
2026-04-23	587cd931	Changes to caddy configuration
2026-04-23	d9692222	Configuration update for OIDC
2026-04-23	1551b298	Environment variable updates
2026-04-23	7af7f886	Optimizations for service performance
2026-04-23	475445eb	Updates to Docker Swarm config

Generated by Gremlin on 2026-04-23T22:53:56.270Z Source: swarm/mealie.yaml Review User Guide and Changelog sections