From 2f2ae1836cfad53b65e8c49493ec55dc60d0e20b Mon Sep 17 00:00:00 2001 From: traveler Date: Tue, 21 Apr 2026 14:56:57 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 88 ++++++++++++++++++--------- 1 file changed, 58 insertions(+), 30 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 2a6d1e0..94226d1 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -2,24 +2,23 @@ title: mealie Stack description: Recipe Manager published: true -date: 2026-04-21T19:36:38.533Z +date: 2026-04-21T19:55:18.061Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-21T19:36:38.533Z +dateCreated: 2026-04-21T19:55:18.061Z --- # mealie ## Overview -The mealie stack is a Docker Swarm configuration for the Mealie recipe manager service in NetGrimoire. This service provides a centralized platform for managing recipes and users. +The mealie stack is a Docker Swarm configuration for the Mealie recipe manager service in NetGrimoire. This stack provides a secure and scalable environment for users to access and manage their recipes. ## Architecture - | Service | Image | Port | Role | -|---------|-------|------|------| +|---------|-----|-----|-----| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com` (Caddy reverse proxy) +- **Exposed via:** recipe.netgrimoire.com - **Homepage group:** PNCHarris Apps --- @@ -27,19 +26,41 @@ The mealie stack is a Docker Swarm configuration for the Mealie recipe manager s ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +This service requires the following prerequisites: +* Docker Swarm manager and worker nodes configured +* Caddy reverse proxy setup with labels for domain mapping +* Uptime Kuma monitoring enabled with kuma.* labels ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R 1964:1964 /DockerVol/mealie +chown -R mealie:mealie /DockerVol/mealie ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 -OIDC_CLIENT_ID: tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz -OIDC_CLIENT_SECRET: OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK +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 @@ -53,7 +74,7 @@ docker stack services mealie ``` ### First Run -No specific post-deploy steps are required for this service. +On the first run, ensure that the Caddy reverse proxy is configured correctly and the Uptime Kuma monitoring is enabled. --- @@ -62,30 +83,34 @@ No specific post-deploy steps are required for this service. ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **recipe**: `https://recipe.netgrimoire.com` -- Primary authentication method: OIDC with Authentik provider. +- **Recipe Manager:** recipe.netgrimoire.com +- **Caddy Domains:** recipe:9000 ### Primary Use Cases -This stack provides a centralized platform for managing recipes and users in NetGrimoire. It can be accessed through the Caddy reverse proxy at `recipe.netgrimoire.com`. +This service provides a secure and scalable environment for users to access and manage their recipes. Users can create, edit, and delete recipes, as well as manage user permissions and authentication. ### NetGrimoire Integrations -The mealie service integrates with other services in NetGrimoire, such as Uptime Kuma for monitoring and Diun for enabling. +This service integrates with other services in NetGrimoire, including the authentik OIDC provider and Uptime Kuma monitoring. --- ## Operations ### Monitoring -[kuma.name: Mealie] +Uptime Kuma monitors the Mealie service with kuma.* labels: ```bash docker stack services mealie - +``` +Check for any errors or issues: +``` +docker service logs -f mealie ``` ### Backups -Critical data is stored on the /DockerVol/mealie volume. Make sure to backup this volume regularly to ensure data integrity. +Critical data is stored on `/DockerVol/mealie`. Ensure that this volume is backed up regularly. ### Restore +Restore the Mealie service by running the following command: ```bash cd services/swarm/stack/mealie ./deploy.sh @@ -96,9 +121,9 @@ cd services/swarm/stack/mealie ## Common Failures | Symptom | Cause | Fix | |---------|-------|-----| -- Service not starting | Insufficient CPU resources | Scale service up or increase resource allocation | -- Caddy reverse proxy issues | Caddy configuration errors | Review and update Caddy configuration files | -- OIDC authentication issues | Invalid client ID or secret | Update OIDC client ID and secret in environment variables | +| Service not responding | Caddy reverse proxy configuration issue | Check Caddy logs and restart service | +| Authentication issues | OIDC provider configuration issue | Check authentik logs and update OIDC configuration | +| Data corruption | Docker volume issues | Check Docker logs and ensure proper volume setup | --- @@ -106,12 +131,15 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-21 | 1829bf97 | Initial documentation creation | -| 2026-04-20 | 67ef1d4b | Revised Caddy configuration for improved security | -| 2026-04-20 | 53e99284 | Updated OIDC client ID and secret for better security | -| 2026-04-20 | 7cf2df8b | Enhanced logging and monitoring for mealie service | -| 2026-04-20 | 02a2898b | Fixed critical bug in Caddy reverse proxy configuration | +| 2026-04-21 | fdd16eff | Initial documentation for mealie stack | +| 2026-04-21 | 1829bf97 | Updated Caddy reverse proxy configuration | +| 2026-04-20 | 67ef1d4b | Fixed OIDC provider configuration issue | +| 2026-04-20 | 53e99284 | Improved Docker volume setup | +| 2026-04-20 | 7cf2df8b | Updated Uptime Kuma monitoring configuration | - - - \ No newline at end of file +--- + +## Notes +- Generated by Gremlin on 2026-04-21T19:55:18.061Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file