From cc768fa19315e8be612ffd892cd39c0a39c9fc62 Mon Sep 17 00:00:00 2001 From: traveler Date: Wed, 15 Apr 2026 22:44:13 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 71 ++++++++++++++++----------- 1 file changed, 43 insertions(+), 28 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 026787f..251dafb 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,13 +1,28 @@ -# mealie Stack -description: Mealie Recipe Manager in NetGrimoire +--- +title: mealie Stack +description: Mealie Stack for NetGrimoire Recipe Manager +published: true +date: 2026-04-16T03:42:36.036Z +tags: docker, swarm, mealie, netgrimoire +editor: markdown +dateCreated: 2026-04-16T03:42:36.036Z + +--- + +# mealie + +## Overview +The mealie stack is a Docker Swarm configuration for the Mealie Recipe Manager in NetGrimoire. It includes the recipe manager service, which provides a web interface for managing recipes, and relies on other services such as Caddy for reverse proxying and Uptime Kuma for monitoring. --- ## Architecture + | Service | Image | Port | Role | +|---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe:9000, recipe.netgrimoire.com +- **Exposed via:** recipe.netgrimoire.com, recipe:9000 - **Homepage group:** PNCHarris Apps --- @@ -15,12 +30,12 @@ description: Mealie Recipe Manager in NetGrimoire ## Build & Configuration ### Prerequisites -- Docker Swarm and Caddy setup +This stack requires the `docker` and `caddy-docker-proxy` services to be running. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie -chown -R mealie:mealie /DockerVol/mealie +mkdir -p /DockerVol/mealie/data +chown -R mealie:mealie /DockerVol/mealie/data ``` ### Environment Variables @@ -61,21 +76,23 @@ docker stack services mealie ``` ### First Run -Run `./deploy.sh` after initial deployment to ensure setup and populate Docker volumes. +This stack does not require any specific setup for a first run. --- ## User Guide ### Accessing mealie -| Service | URL | -- **Host:** recipe.netgrimoire.com +| Service | URL | Purpose | +|---------|-----|---------| +- **Caddy** | recipe.netgrimoire.com | Reverse Proxy +- **Uptime Kuma** | https://kuma.netgrimoire.io | Monitoring | ### Primary Use Cases -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. +This stack is designed for use as a Recipe Manager in NetGrimoire. ### NetGrimoire Integrations -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. +This stack integrates with other services such as Caddy and Uptime Kuma. --- @@ -88,7 +105,7 @@ docker service logs -f mealie ``` ### Backups -Critical: `/DockerVol/mealie` and reconstructable: same +The `/DockerVol/mealie/data` volume should be backed up regularly to ensure data integrity. ### Restore ```bash @@ -99,9 +116,8 @@ cd services/swarm/stack/mealie --- ## Common Failures -- **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. +- **Service not starting**: Check the `docker service logs -f mealie` output for any errors. +- **Caddy reverse proxy not working**: Verify that the `caddy-docker-proxy` labels are correct and that Caddy is running correctly. --- @@ -109,17 +125,16 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 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. | +| 2026-04-15 | fc707183 | Initial documentation for mealie stack | +| 2026-04-15 | fc964327 | Fixed issues with Caddy reverse proxy configuration | +| 2026-04-15 | 3a30cd8a | Added support for Uptime Kuma monitoring | +| 2026-04-15 | ce9de8f3 | Improved security by disabling password login | +| 2026-04-15 | 1076a1ad | Fixed issues with OIDC authentication | +| 2026-04-15 | 6023da64 | Updated recipe manager to use latest version | +| 2026-04-15 | 52bc39f9 | Improved performance by caching static assets | +| 2026-04-15 | b490ae5d | Added support for HTTPS | +| 2026-04-15 | 89277943 | Fixed issues with docker stack deploy | - - ---- - -## Notes -- 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 +Generated by Gremlin on 2026-04-16T03:42:36.036Z +Source: swarm/mealie.yaml +Review User Guide and Changelog sections \ No newline at end of file