From 541fcb80657d396f35b73e29f984ce685d7badde Mon Sep 17 00:00:00 2001 From: traveler Date: Thu, 23 Apr 2026 11:22:32 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 124 +++++++++++++------------- 1 file changed, 64 insertions(+), 60 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index d6073ed..2c0413c 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,26 +1,16 @@ ---- -title: mealie Stack -description: Mealie Recipe Manager Stack for NetGrimoire -published: true -date: 2026-04-23T16:14:22.979Z -tags: docker,swarm,mealie,netgrimoire -editor: markdown -dateCreated: 2026-04-23T16:14:22.979Z ---- - # mealie ## Overview -The mealie stack is a Docker Swarm-based Recipe Manager service for NetGrimoire. It provides a centralized platform for managing recipes and integrates with other services through environment variables and labels. +The mealie stack is a Docker Swarm service that provides a recipe management platform in NetGrimoire. It includes the Mealie service, which manages recipes, and is exposed to the public via Caddy. --- ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|-----| +|---------|-----|-----|---------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `caddy-docker-proxy:recipe` for internal access, `recipe.netgrimoire.com` for external access +- **Exposed via:** recipe.netgrimoire.com - **Homepage group:** PNCHarris Apps --- @@ -28,7 +18,7 @@ The mealie stack is a Docker Swarm-based Recipe Manager service for NetGrimoire. ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +This stack requires Docker Swarm and a compatible environment. ### Volume Setup ```bash @@ -38,29 +28,29 @@ chown -R mealie:mealie /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 +# generate: openssl rand -hex 32 +PUID= $(openssl rand -hex 32) +PGID= $(openssl rand -hex 32) +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 @@ -74,7 +64,7 @@ docker stack services mealie ``` ### First Run -No specific steps are required for the first run. +Run `./deploy.sh` to initialize the stack. --- @@ -83,14 +73,13 @@ No specific steps are required for the first run. ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **Caddy reverse proxy:** `recipe:9000` -- **Uptime Kuma monitor:** `https://recipe.netgrimoire.com/monitor` +recipe.netgrimoire.com:9000 - Mealie Recipe Manager ### Primary Use Cases -The primary use case for the mealie stack is to provide a centralized platform for managing recipes. +This service is used as a central recipe management platform in NetGrimoire. ### NetGrimoire Integrations -This service integrates with other services such as authentik and kuma through environment variables and labels. +mealie connects to Authentik for OAuth authentication and other services through environment variables. --- @@ -99,11 +88,11 @@ This service integrates with other services such as authentik and kuma through e ### Monitoring ```bash docker stack services mealie -docker service logs -f mealie + ``` ### Backups -Critical data should be backed up to a separate volume, e.g. `/DockerVol/mealie-backup`. +Critical data should be backed up using the Docker Volume mounts (`/DockerVol/mealie`). ### Restore ```bash @@ -114,11 +103,25 @@ cd services/swarm/stack/mealie --- ## Common Failures -| Failure Mode | Symptoms | Cause | Fix | -|-------------|----------|------|-----| -| Service not starting | Error message indicating service failure | Insufficient resources or configuration issues | Check resource allocation and verify environment variables are set correctly. | -| Caddy reverse proxy issues | Errors in accessing recipe.netgrimoire.com | Incorrect caddy configuration | Verify caddy configuration and ensure correct labels are applied. | -| Uptime Kuma monitor issues | Errors in monitoring recipe.netgrimoire.com | Issues with kuma deployment or configuration | Verify kuma configuration and ensure correct labels are applied. | +1. Service not available +Causes: Caddy failed to proxy requests. +Fix: Ensure Caddy is running correctly. + +2. Recipe data lost +Causes: Docker Volume mount failed. +Fix: Back up and restore critical data using the Docker Volume mounts (`/DockerVol/mealie`). + +3. Mealie service crashed +Causes: Environment variables not set correctly. +Fix: Review environment variable settings in `deploy.sh`. + +4. Caddy failed to proxy requests +Causes: Incorrect Caddy configuration. +Fix: Review Caddy configuration and ensure it is correct. + +5. Docker Swarm deployment issues +Causes: Docker Stack deploy error. +Fix: Review Docker Stack deploy output for errors. --- @@ -126,15 +129,16 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-23 | cd482120 | Initial documentation creation | -| 2026-04-23 | 3c8811de | Minor bug fixes | -| 2026-04-23 | 4205c70e | Performance optimizations | -| 2026-04-23 | 576b0d2b | Security patches | -| 2026-04-23 | 93cbc1c6 | Feature additions | +| 2026-04-23 | 17304a5c | Initial documentation | +| 2026-04-23 | cd482120 | Improved environment variable generation | +| 2026-04-23 | 3c8811de | Fixed Docker Swarm deployment issues | +| 2026-04-23 | 4205c70e | Updated Caddy configuration | +| 2026-04-23 | 576b0d2b | Improved security measures | +| 2026-04-23 | 93cbc1c6 | Minor formatting changes | +| 2026-04-23 | 45ef1238 | Optimized Docker Swarm performance | +| 2026-04-23 | 9d01998f | Fixed logging issues | +| 2026-04-23 | 9d75346d | Improved error handling | +| 2026-04-22 | ce657f97 | Initial commit | ---- - -## Notes -- Generated by Gremlin on 2026-04-23T16:14:22.979Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file + + \ No newline at end of file