From 7d8bee196fdbc5b94da133c255abae6da4e1ed00 Mon Sep 17 00:00:00 2001 From: traveler Date: Mon, 20 Apr 2026 14:32:36 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 71 ++++++++++++++------------- 1 file changed, 37 insertions(+), 34 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index eece191..51f5aa9 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,23 +1,25 @@ --- - title: mealie Stack description: Recipe Manager for NetGrimoire - +published: true +date: 2026-04-20T19:31:01.116Z +tags: docker,swarm,mealie,netgrimoire +editor: markdown +dateCreated: 2026-04-20T19:31:01.116Z --- + # mealie ## Overview -The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and integrates with other services such as Authentik and CrowdSec. - ---- +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. ## Architecture | Service | Image | Port | Role | -|---------|-------|-----|------| +|---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe:9000, recipe.netgrimoire.com (caddy labels) +- **Exposed via:** recipe:9000 - **Homepage group:** PNCHarris Apps --- @@ -25,17 +27,17 @@ The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe ma ## Build & Configuration ### Prerequisites -- Set up Docker Swarm manager and worker nodes with the required environment variables. +No specific prerequisites are required for this stack. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R user:group /DockerVol/mealie +chown -R www-data:www-data /DockerVol/mealie ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 for secrets +# generate: openssl rand -hex 32 PUID=1964 PGID=1964 TZ=America/Chicago @@ -71,7 +73,7 @@ docker stack services mealie ``` ### First Run -- After the initial deployment, verify that the service is running correctly and update any necessary configuration files. +After the initial deployment, verify that the recipe service is running and accessible via Caddy. --- @@ -80,44 +82,41 @@ docker stack services mealie ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- recipe:9000 (caddy labels) -- recipe.netgrimoire.com (Caddy reverse proxy) +recipe: https://recipe.netgrimoire.com ### Primary Use Cases -- Manage recipes and ingredients. -- Integrate with other NetGrimoire services. +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. ### NetGrimoire Integrations -- Authentik authentication and authorization. -- CrowdSec integration for security monitoring. +This stack connects to other services in NetGrimoire via environment variables and labels. The specific integrations include: + +- authentik --- ## Operations ### Monitoring -- Check the service logs using `docker stack services mealie`. +Monitor the health of the recipe service using Kuma. + ```bash docker stack services mealie docker service logs -f mealie ``` ### Backups -- Store critical data in a separate, reconstructable volume to ensure data integrity. -- Use `rsync` or similar tool to synchronize the backup with the production volume. +Critical backups are required to ensure data integrity. Store backup images in a secure location. ### Restore -```bash -cd services/swarm/stack/mealie -./deploy.sh -``` +Restore the mealie service by redeploying from the swarm configuration file. --- ## Common Failures -- **Service not running**: Check the service logs and verify that the Docker stack is deployed correctly. -- **Authentication issues**: Ensure that the Authentik authentication settings are correct. -- **Caddy reverse proxy configuration issues**: Verify that the Caddy labels are applied correctly. +| 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 | --- @@ -125,11 +124,15 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-20 | c77cd7d4 | Initial documentation and setup. | -| 2026-04-20 | f397da91 | Minor bug fixes and code optimizations. | -| 2026-04-20 | 5b7ee307 | Improved Caddy reverse proxy configuration. | -| 2026-04-19 | e9ad12cd | Authentik authentication settings updated. | +| 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 | -Generated by Gremlin on 2026-04-20T19:23:57.949Z -Source: swarm/mealie.yaml -Review User Guide and Changelog sections \ No newline at end of file +--- + +## Notes +- Generated by Gremlin on 2026-04-20T19:31:01.116Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file