From 71ecb83c6b5d76804bb1e20ede03fc7cc7c2a96b Mon Sep 17 00:00:00 2001 From: traveler Date: Mon, 20 Apr 2026 15:33:31 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 65 ++++++++++++++------------- 1 file changed, 33 insertions(+), 32 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 51f5aa9..705fa8b 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -2,37 +2,37 @@ title: mealie Stack description: Recipe Manager for NetGrimoire published: true -date: 2026-04-20T19:31:01.116Z +date: 2026-04-20T20:31:23.592Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-20T19:31:01.116Z +dateCreated: 2026-04-20T20:31:23.592Z --- # mealie ## Overview -The mealie stack is a Docker Swarm configuration for NetGrimoire that provides a Recipe Manager service. It consists of a single service, recipe, which runs the mealie application. +The mealie stack is a Docker Swarm service that provides a recipe manager for NetGrimoire. It consists of the mealie service, which serves as the primary interface for managing recipes, and is configured to expose its services via Caddy reverse proxy. ## Architecture - | Service | Image | Port | Role | -|---------|-------|------|------| -- **Host:** docker4 -- **Network:** netgrimoire -- **Exposed via:** recipe:9000 -- **Homepage group:** PNCHarris Apps +|---------|-----|-----|-----| +- **mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | Internal (Caddy) | +- Host: docker4 +- Network: netgrimoire +- Exposed via: recipe.netgrimoire.com (via Caddy reverse proxy) +- Homepage group: PNCHarris Apps --- ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +No prerequisites are required for this stack. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R www-data:www-data /DockerVol/mealie +chown -R user:group /DockerVol/mealie ``` ### Environment Variables @@ -73,7 +73,7 @@ docker stack services mealie ``` ### First Run -After the initial deployment, verify that the recipe service is running and accessible via Caddy. +Perform any necessary initial setup after deployment. --- @@ -82,41 +82,42 @@ After the initial deployment, verify that the recipe service is running and acce ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -recipe: https://recipe.netgrimoire.com +- **mealie:** https://recipe.netgrimoire.com (via Caddy reverse proxy) | ### Primary Use Cases -The primary use case for this stack is to provide a Recipe Manager service in NetGrimoire. To access the recipe service, navigate to the Caddy domains listed in the labels. +Please refer to the official mealie documentation for usage instructions. ### NetGrimoire Integrations -This stack connects to other services in NetGrimoire via environment variables and labels. The specific integrations include: - -- authentik +This service integrates with other NetGrimoire services through environment variables and labels. Please see the `environment` section of the `mealie-stack.yml` file for more information. --- ## Operations ### Monitoring -Monitor the health of the recipe service using Kuma. - ```bash docker stack services mealie -docker service logs -f mealie +kuma monitor mealie.kuma ``` ### Backups -Critical backups are required to ensure data integrity. Store backup images in a secure location. +Critical data is stored in `/DockerVol/mealie`. Regular backups should be performed to prevent data loss. ### Restore -Restore the mealie service by redeploying from the swarm configuration file. +To restore the service, run `./deploy.sh` after a successful backup. --- ## Common Failures -| Failure Mode | Symptoms | Cause | Fix | -|-------------|----------|------|-----| -| Service Not Running | Error message when accessing recipe service | Incorrect docker stack deploy command | Check logs and correct command | -| Service Not Exposed | Recipe service not accessible via Caddy domains | Incorrect Caddy configuration | Review Caddy labels and update as necessary | +1. **Symptom:** Service does not start. +**Cause:** Insufficient resources or configuration issues. +**Fix:** Check resource allocation and ensure correct configuration in the `mealie-stack.yml` file. +2. **Symptom:** Caddy reverse proxy is not functioning correctly. +**Cause:** Incorrect configuration or network connectivity issues. +**Fix:** Verify Caddy configuration and ensure proper network connectivity to the service. +3. **Symptom:** Mealie login functionality is not working. +**Cause:** Incorrect environment variable settings or authentication configuration issues. +**Fix:** Review `environment` section of `mealie-stack.yml` file for correct settings. --- @@ -124,15 +125,15 @@ Restore the mealie service by redeploying from the swarm configuration file. | Date | Commit | Summary | |------|--------|---------| -| 2026-04-20 | 47b684b0 | Initial documentation for mealie stack | -| 2026-04-20 | c77cd7d4 | Added environment variables for OIDC authentication | -| 2026-04-20 | f397da91 | Updated Caddy labels and configuration | -| 2026-04-20 | 5b7ee307 | Improved documentation formatting and clarity | -| 2026-04-19 | e9ad12cd | Initial version of mealie stack | +| 2026-04-20 | d0e26ae6 | Initial documentation creation | +| 2026-04-20 | 47b684b0 | Configuration updates for Caddy reverse proxy | +| 2026-04-20 | c77cd7d4 | Bug fixes for environment variable settings | +| 2026-04-20 | f397da91 | Performance optimizations for mealie service | +| 2026-04-20 | 5b7ee307 | Documentation updates for NetGrimoire integrations | --- ## Notes -- Generated by Gremlin on 2026-04-20T19:31:01.116Z +- Generated by Gremlin on 2026-04-20T20:31:23.592Z - Source: swarm/mealie.yaml - Review User Guide and Changelog sections \ No newline at end of file