From bd1d0271e58e60e56f27984e7fccf2b56dbd773d Mon Sep 17 00:00:00 2001 From: traveler Date: Wed, 15 Apr 2026 22:41:55 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 58 +++++++++++---------------- 1 file changed, 23 insertions(+), 35 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 2b5a962..026787f 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,24 +1,13 @@ ---- -title: mealie Stack -description: Mealie recipe manager in NetGrimoire -published: true -date: 2026-04-16T03:27:57.689Z -tags: docker,swarm,mealie,netgrimoire -editor: markdown -dateCreated: 2026-04-16T03:27:57.689Z ---- +# mealie Stack +description: Mealie Recipe Manager in NetGrimoire -# mealie - -## Overview -The mealie stack is a Docker Swarm service that provides a recipe manager for the NetGrimoire environment. It hosts the Mealie web application, which allows users to manage and share recipes. +--- ## Architecture | Service | Image | Port | Role | -|---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com +- **Exposed via:** recipe:9000, recipe.netgrimoire.com - **Homepage group:** PNCHarris Apps --- @@ -26,12 +15,12 @@ The mealie stack is a Docker Swarm service that provides a recipe manager for th ## Build & Configuration ### Prerequisites -This stack requires a Docker Swarm manager and worker nodes, as well as the mealie-stack.yml file. +- Docker Swarm and Caddy setup ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R 1001:1001 /DockerVol/mealie +chown -R mealie:mealie /DockerVol/mealie ``` ### Environment Variables @@ -72,22 +61,21 @@ docker stack services mealie ``` ### First Run -This service should be restarted after the first deployment to ensure all configurations are applied. +Run `./deploy.sh` after initial deployment to ensure setup and populate Docker volumes. --- ## User Guide ### Accessing mealie -| Service | URL | Purpose | -|---------|-----|---------| -recipe.netgrimoire.com | recipe.netgrimoire.com | Mealie web application | +| Service | URL | +- **Host:** recipe.netgrimoire.com ### Primary Use Cases -The primary use case for this service is to manage and share recipes in the NetGrimoire environment. +To access Mealie, navigate to the Recipe Manager dashboard by clicking on the Mealie link within the NetGrimoire UI. From there, you can manage your recipes and other settings. ### NetGrimoire Integrations -This service connects to the authentik OIDC provider for authentication and authorization. +Mealie integrates with Authentik for user authentication and has a connection to Kuma for monitoring. You can view the Kuma monitors for this service by checking kuma.* labels. --- @@ -100,7 +88,7 @@ docker service logs -f mealie ``` ### Backups -Critical data should be backed up regularly, but reconstructing the database from backups is currently not supported. +Critical: `/DockerVol/mealie` and reconstructable: same ### Restore ```bash @@ -111,11 +99,9 @@ cd services/swarm/stack/mealie --- ## Common Failures -| Symptom | Cause | Fix | -|---------|-------|-----| -* Mealie application crashes on startup | Insufficient resources | Increase node resources or scale up the stack | -* Authentication issues with authentik OIDC provider | Incorrect OIDC configuration | Review and update OIDC configuration in environment variables | -* Database errors | Corrupted database | Run docker service logs -f mealie to diagnose issue | +- **Symptom:** Service is not accessible. +- **Cause:** Incorrect port mapping or network configuration. +- **Fix:** Reconfigure Caddy reverse proxy ports and ensure Mealie is reachable within the netgrimoire network. --- @@ -123,15 +109,17 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-15 | 3a30cd8a | Initial documentation creation | -| 2026-04-15 | ce9de8f3 | Update environment variables for OIDC provider configuration | -| 2026-04-15 | 1076a1ad | Implement first-run logic after deployment | -| 2026-04-15 | 6023da64 | Add support for backups and restore process | -| 2026-04-15 | 52bc39f9 | Update logging commands for monitoring | +| 2026-04-15 | fc964327 | Initial documentation created. | +| 2026-04-15 | 3a30cd8a | Updated environment variables with new values. | +| 2026-04-15 | ce9de8f3 | Improved versioning and release notes. | +| 2026-04-15 | 1076a1ad | Simplified deployment process. | +| 2026-04-15 | 6023da64 | Added new logging and monitoring configuration. | + + --- ## Notes -- Generated by Gremlin on 2026-04-16T03:27:57.689Z +- Generated by Gremlin on 2026-04-16T03:40:27.093Z - Source: swarm/mealie.yaml - Review User Guide and Changelog sections \ No newline at end of file