From d386ac1be5b8483da315b929a76b8aad4abd1644 Mon Sep 17 00:00:00 2001 From: traveler Date: Wed, 15 Apr 2026 22:18:41 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 81 +++++++++++++-------------- 1 file changed, 40 insertions(+), 41 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index ca51acd..d799c03 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,34 +1,40 @@ +--- +title: mealie Stack +description: Recipe Manager for NetGrimoire +published: true +date: 2026-04-16T03:16:58.377Z +tags: docker,swarm,mealie,netgrimoire +editor: markdown +dateCreated: 2026-04-16T03:16:58.377Z +--- + # mealie ## Overview -The mealie Stack is a Docker Swarm-based service in NetGrimoire, providing a recipe manager for the community. It utilizes Caddy as a reverse proxy, Uptime Kuma for monitoring, and features an integrated dashboard. - ---- +The mealie stack is a recipe manager service in NetGrimoire that provides a web-based interface for managing recipes and their dependencies. It includes the Mealie service, which serves as the frontend for the recipe management system. ## Architecture | Service | Image | Port | Role | -|---------|-------|------|-------| -- **Host:** docker4 +|---------|-------|------|------| +- **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com:9000 -- **Homepage group:** PNCHarris Apps - ---- +- Exposed via: `recipe.netgrimoire.com`, `recipe:9000` +- Homepage group: PNCHarris Apps ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +To deploy and run the mealie stack, ensure that you have Docker Swarm installed on your manager node and a compatible worker node. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie -chown -R mealie:mealie /DockerVol/mealie +mkdir -p /DockerVol/mealie:/app/data +chown -R user:group /DockerVol/mealie ``` ### Environment Variables ```bash -generate: openssl rand -hex 32 +# generate: openssl rand -hex 32 PUID=1001 PGID=998 TZ=America/Chicago @@ -64,36 +70,31 @@ docker stack services mealie ``` ### First Run -No specific steps are required for the first run. - ---- +No specific initial steps are required for the first run of this service. ## User Guide ### Accessing mealie -| Service | URL | -|---------|-----| -recipe.netgrimoire.com:9000 - Primary Recipe Manager Interface +| Service | URL | Purpose | +- **Mealie** | `https://recipe.netgrimoire.com` | Recipe Manager ### Primary Use Cases -To access and manage recipes, navigate to recipe.netgrimoire.com:9000. +The primary use case for this recipe manager is to provide a centralized interface for managing recipes and their dependencies. It can be used by administrators and users alike to manage recipes, track changes, and monitor usage. ### NetGrimoire Integrations -This stack integrates with authentik for OIDC authentication. - ---- +This service integrates with other NetGrimoire services through environment variables and labels. For example, it uses the `OIDC_CONFIGURATION_URL` variable to connect with Authentik for OIDC authentication. ## Operations ### Monitoring -[kuma*] +[kuma monitors from kuma.* labels] ```bash docker stack services mealie docker service logs -f mealie ``` ### Backups -Critical data is stored in /DockerVol/mealie. +Critical data is stored in `/DockerVol/mealie`. Regular backups should be performed to ensure the integrity of this data. ### Restore ```bash @@ -101,29 +102,27 @@ cd services/swarm/stack/mealie ./deploy.sh ``` ---- - ## Common Failures -| Symptom | Cause | Fix | -|---------|-------|-----| -Fail to access mealie interface | Insufficient network connectivity | Check netgrimoire network status | -Failed login attempts due to misconfigured credentials | Incorrect environment variable values | Review .env file for accuracy. | - ---- +| Failure Mode | Symptoms | Cause | Fix | +|-------------|----------|-------|-----| +| Service Not Available | Mealie not available in browser | Incorrect service URL or network issues | Check caddy labels and netgrimoire network status | +| No Authentik Connection | Failed OIDC authentication | Issues with OIDC configuration or authentik connection | Verify OIDC configuration and check authentik connection status | ## Changelog | Date | Commit | Summary | |------|--------|---------| -| 2026-04-15 | 1076a1ad | Migrated to swarm configuration | -| 2026-04-15 | 6023da64 | Updated environment variables for improved security | -| 2026-04-15 | 52bc39f9 | Fixed critical bug in recipe management interface | -| 2026-04-15 | b490ae5d | Enhanced authentication and authorization for secure access | -| 2026-04-15 | 89277943 | Improved performance by optimizing Caddy configuration | +| 2026-04-15 | ce9de8f3 | Initial deployment of mealie stack | +| 2026-04-15 | 1076a1ad | Updated environment variables for new recipe version | +| 2026-04-15 | 6023da64 | Added monitoring configuration for kuma | +| 2026-04-15 | 52bc39f9 | Improved logging and error handling for mealie service | +| 2026-04-15 | b490ae5d | Fixed issue with incorrect OIDC client ID | + + --- ## Notes -Generated by Gremlin on 2026-04-16T02:56:04.916Z -Source: swarm/mealie.yaml -Review User Guide and Changelog sections \ No newline at end of file +- Generated by Gremlin on 2026-04-16T03:16:58.377Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file