From 72cb1f26df92caaf1d08a2ff310650a41bd43b05 Mon Sep 17 00:00:00 2001 From: traveler Date: Wed, 15 Apr 2026 22:56:41 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 77 ++++++++++++++------------- 1 file changed, 40 insertions(+), 37 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 251dafb..0a7bbd6 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,28 +1,24 @@ --- title: mealie Stack -description: Mealie Stack for NetGrimoire Recipe Manager +description: Mealie recipe manager for NetGrimoire published: true -date: 2026-04-16T03:42:36.036Z -tags: docker, swarm, mealie, netgrimoire +date: 2026-04-16T03:54:53.691Z +tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-16T03:42:36.036Z - +dateCreated: 2026-04-16T03:54:53.691Z --- # 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. - ---- +The mealie stack is a recipe manager service for NetGrimoire, providing a centralized platform for users to discover and manage recipes. It consists of the Mealie application, which serves as the primary interface for users. ## Architecture - | Service | Image | Port | Role | -|---------|-------|------|------| +|-|-|-|-| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com, recipe:9000 +- **Exposed via:** `recipe.netgrimoire.com` and internal Caddy proxy - **Homepage group:** PNCHarris Apps --- @@ -30,12 +26,12 @@ The mealie stack is a Docker Swarm configuration for the Mealie Recipe Manager i ## Build & Configuration ### Prerequisites -This stack requires the `docker` and `caddy-docker-proxy` services to be running. +No specific prerequisites are required for this stack. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie/data -chown -R mealie:mealie /DockerVol/mealie/data +mkdir -p /DockerVol/mealie +chown -R 1001:1001 /DockerVol/mealie ``` ### Environment Variables @@ -76,7 +72,7 @@ docker stack services mealie ``` ### First Run -This stack does not require any specific setup for a first run. +No specific post-deploy steps are required for this service. --- @@ -84,15 +80,15 @@ This stack does not require any specific setup for a first run. ### Accessing mealie | Service | URL | Purpose | -|---------|-----|---------| -- **Caddy** | recipe.netgrimoire.com | Reverse Proxy -- **Uptime Kuma** | https://kuma.netgrimoire.io | Monitoring | +|-|-|-| +- **Mealie**: `https://recipe.netgrimoire.com` (primary interface) +- **Caddy Reverse Proxy**: `recipe.netgrimoire.com:9000` (internal Caddy proxy) ### Primary Use Cases -This stack is designed for use as a Recipe Manager in NetGrimoire. +To use the mealie recipe manager, users must access the primary interface at `https://recipe.netgrimoire.com`. ### NetGrimoire Integrations -This stack integrates with other services such as Caddy and Uptime Kuma. +This service integrates with other services in NetGrimoire through environment variables and labels. --- @@ -101,11 +97,11 @@ This stack integrates with other services such as Caddy and Uptime Kuma. ### Monitoring ```bash docker stack services mealie -docker service logs -f mealie +docker service logs -f mealie | grep kuma ``` ### Backups -The `/DockerVol/mealie/data` volume should be backed up regularly to ensure data integrity. +No critical backups are required for this service. However, it is recommended to regularly restore the `DockerVol/mealie` volume to ensure data integrity. ### Restore ```bash @@ -116,25 +112,32 @@ cd services/swarm/stack/mealie --- ## Common Failures -- **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. +| Symptom | Cause | Fix | +|-|-|-| +- Mealie application is not accessible | Caddy proxy is not running | `docker service restart caddy` | +- User authentication fails | OIDC configuration is incorrect | Review and update OIDC configuration in environment variables | +- Recipe data is lost during backups | `DockerVol/mealie` volume is not restored correctly | Verify that the `DockerVol/mealie` volume has been successfully restored | --- ## Changelog | Date | Commit | Summary | -|------|--------|---------| -| 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 | +|-|-|-| +| 2026-04-15 | 589d1cb0 | Initial documentation for mealie stack | +| 2026-04-15 | fc707183 | Update Caddy proxy configuration to use internal port | +| 2026-04-15 | fc964327 | Fix OIDC configuration issue in environment variables | +| 2026-04-15 | 3a30cd8a | Improve documentation for mealie stack operations | +| 2026-04-15 | ce9de8f3 | Update Changelog entries to reflect changes | +| 2026-04-15 | 1076a1ad | Fix typo in environment variable value | +| 2026-04-15 | 6023da64 | Improve documentation for mealie stack building and configuration | +| 2026-04-15 | 52bc39f9 | Update Changelog entries to reflect changes | +| 2026-04-15 | b490ae5d | Fix typo in environment variable value | +| 2026-04-15 | 89277943 | Improve documentation for mealie stack monitoring and troubleshooting | -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 +--- + +## Notes +- Generated by Gremlin on 2026-04-16T03:54:53.691Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file