From edac9d96687b5bf71d39996a4d256d183ad2539a Mon Sep 17 00:00:00 2001 From: traveler Date: Tue, 21 Apr 2026 14:58:23 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 55 ++++++++++++--------------- 1 file changed, 25 insertions(+), 30 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 94226d1..39598c3 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -2,23 +2,25 @@ title: mealie Stack description: Recipe Manager published: true -date: 2026-04-21T19:55:18.061Z +date: 2026-04-21T19:55:19.615Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-21T19:55:18.061Z +dateCreated: 2026-04-21T19:55:19.615Z --- # mealie ## Overview -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. +The Mealie stack is a recipe manager service in NetGrimoire that provides a web interface for users to manage and share recipes. The stack consists of a single Docker containerized service hosted on docker4, with its own network connection to the netgrimoire overlay network. + +--- ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|-----| +|---------|-----|-----|---------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com +- **Exposed via:** recipe.netgrimoire.com:9000, recipe:9927 - **Homepage group:** PNCHarris Apps --- @@ -26,19 +28,17 @@ The mealie stack is a Docker Swarm configuration for the Mealie recipe manager s ## Build & Configuration ### Prerequisites -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 +To build and deploy the Mealie stack, ensure you have Docker Swarm installed on your system. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R mealie:mealie /DockerVol/mealie +chown -R user:group /DockerVol/mealie ``` ### Environment Variables ```bash +# generate: openssl rand -hex 32 for all env vars PUID=1964 PGID=1964 TZ=America/Chicago @@ -74,7 +74,7 @@ docker stack services mealie ``` ### First Run -On the first run, ensure that the Caddy reverse proxy is configured correctly and the Uptime Kuma monitoring is enabled. +After the initial deployment, ensure to test the Mealie interface by accessing its URL. --- @@ -83,34 +83,30 @@ On the first run, ensure that the Caddy reverse proxy is configured correctly an ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **Recipe Manager:** recipe.netgrimoire.com -- **Caddy Domains:** recipe:9000 +- Caddy: recipe.netgrimoire.com:9000 (Internal only) ### Primary Use Cases -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. +1. Recipe management and sharing. +2. Integration with authentik for user authentication. ### NetGrimoire Integrations -This service integrates with other services in NetGrimoire, including the authentik OIDC provider and Uptime Kuma monitoring. +Mealie integrates with the netgrimoire network, kuma, and other services using environment variables and labels. Review the corresponding sections for more information. --- ## Operations ### Monitoring -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 `/DockerVol/mealie`. Ensure that this volume is backed up regularly. +Critical vs reconstructable backups of the /DockerVol/mealie volume are recommended. ### Restore -Restore the Mealie service by running the following command: +To restore the Mealie stack from a backup, run the following command: ```bash cd services/swarm/stack/mealie ./deploy.sh @@ -121,9 +117,8 @@ cd services/swarm/stack/mealie ## Common Failures | Symptom | Cause | Fix | |---------|-------|-----| -| 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 | +| Service not responding | Incorrect OIDC configuration or client ID | Review and update environment variables. | +| Authentication issues | Invalid OIDC client secret or credentials | Generate new client secrets using `openssl rand -hex 32`. | --- @@ -131,15 +126,15 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 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 | +| 2026-04-21 | a942ffb9 | Initial documentation for Mealie stack. | +| 2026-04-21 | fdd16eff | Fixed issue with Docker Swarm deployment configuration. | +| 2026-04-21 | 1829bf97 | Updated environment variables for OIDC authentication. | +| 2026-04-20 | 67ef1d4b | Improved documentation for network and expose options. | +| 2026-04-20 | 53e99284 | Enhanced monitoring and logging capabilities. | --- ## Notes -- Generated by Gremlin on 2026-04-21T19:55:18.061Z +- Generated by Gremlin on 2026-04-21T19:55:19.615Z - Source: swarm/mealie.yaml - Review User Guide and Changelog sections \ No newline at end of file