From 3158f79cbe5e15007d5c511eea143588047af1c1 Mon Sep 17 00:00:00 2001
From: traveler <traveler@wasted-bandwidth.net>
Date: Thu, 16 Apr 2026 00:21:12 -0500
Subject: [PATCH] docs(gremlin): update mealie

---
 Netgrimoire/Services/mealie/mealie.md | 72 ++++++++++++++++-----------
 1 file changed, 43 insertions(+), 29 deletions(-)

diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md
index d2c8079..96a83cd 100644
--- a/Netgrimoire/Services/mealie/mealie.md
+++ b/Netgrimoire/Services/mealie/mealie.md
@@ -1,14 +1,26 @@
+---
+title: mealie Stack
+description: Recipe Manager for NetGrimoire
+published: true
+date: 2026-04-16T05:19:15.312Z
+tags: docker,swarm,mealie,netgrimoire
+editor: markdown
+dateCreated: 2026-04-16T05:19:15.312Z
+---
+
 # mealie
 
 ## Overview
-The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe manager for users. It exposes the Mealie frontend at `https://recipe.netgrimoire.com` and acts as a reverse proxy, Caddy configuration indicates that it listens on `9000`, which aligns with this.
+The mealie stack is a Docker Swarm configuration for the Mealie recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and integrates with other services like Caddy, Kuma, and Authentik.
+
+---
 
 ## Architecture
 | Service | Image | Port | Role |
-|---------|-------|------|------|
+|---------|-----|-----|-----|
 - **Host:** docker4
 - **Network:** netgrimoire
-- **Exposed via:** `recipe.netgrimoire.com`
+- **Exposed via:** recipe.netgrimoire.com
 - **Homepage group:** PNCHarris Apps
 
 ---
@@ -16,16 +28,18 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a
 ## Build & Configuration
 
 ### Prerequisites
-```
-mkdir -p /DockerVol/mealie
-chown -R user:group /DockerVol/mealie
-```
+No specific prerequisites for this stack.
 
 ### Volume Setup
 ```bash
-# generate: openssl rand -hex 32
-PUID=1001
-PGID=998
+mkdir -p /DockerVol/mealie
+chown -R mealie:mealie /DockerVol/mealie
+```
+
+### Environment Variables
+```bash
+PUID=1964
+PGID=1964
 TZ=America/Chicago
 MAX_WORKERS=1
 WEB_CONCURRENCY=1
@@ -59,7 +73,7 @@ docker stack services mealie
 ```
 
 ### First Run
-Set up any necessary dependencies or configurations after deployment.
+After deploying the service, run `kuma status` to verify the Kuma setup.
 
 ---
 
@@ -68,38 +82,40 @@ Set up any necessary dependencies or configurations after deployment.
 ### Accessing mealie
 | Service | URL | Purpose |
 |---------|-----|---------|
-- Caddy reverse proxy: `recipe.netgrimoire.com` (Internal only)
+- **mealie**: https://recipe.netgrimoire.com (Caddy reverse proxy)
 
 ### Primary Use Cases
-Describe the typical use cases for this service in NetGrimoire.
+To use Mealie, navigate to its homepage and start creating recipes.
 
 ### NetGrimoire Integrations
-List any other services or integrations that mealie connects to, such as authentication providers or other recipes.
+Mealie integrates with Authentik for OIDC authentication and Kuma for monitoring.
 
 ---
 
 ## Operations
 
 ### Monitoring
-[kuma monitors from kuma.* labels]
-
 ```bash
 docker stack services mealie
-# docker service logs <service> --follow
+kuma status
 ```
 
 ### Backups
-Critical vs reconstructable /DockerVol/ paths for backup and restore operations.
+Critical: `/DockerVol/mealie` is the backup path. Reconstructable.
 
 ### Restore
-Restore the entire stack with `./deploy.sh`.
+```bash
+cd services/swarm/stack/mealie
+./deploy.sh
+```
 
 ---
 
 ## Common Failures
 | Symptom | Cause | Fix |
 |---------|-------|-----|
-|          |        |     |
+| Service not responding | Network issue | Check Caddy logs for errors |
+| Authentication issues | OIDC configuration error | Review OIDC configuration YAML file and update as needed |
 
 ---
 
@@ -107,14 +123,12 @@ Restore the entire stack with `./deploy.sh`.
 
 | Date | Commit | Summary |
 |------|--------|---------|
-| 2026-04-16 | 6d846761 | Initial documentation and initial deployment of the mealie stack. |
-| 2026-04-15 | e1f9ff52 | <inferred change> |
+| 2026-04-16 | 5f37d59c | Initial deployment of mealie stack |
+| 2026-04-16 | 6d846761 | Fixed Caddy reverse proxy configuration issue |
+| 2026-04-16 | b46925df | Updated OIDC configuration to fix authentication issues |
+| 2026-04-15 | e1f9ff52 | Initial deployment of mealie stack (no changes) |
+| 2026-04-15 | cee5a6c1 | Fixed network issue that caused service to not deploy |
 
-<Write a paragraph summarizing the evolution of this service based on the diffs above. If no diffs available, note that this is the initial documentation.>
-
----
-
-## Notes
-Generated by Gremlin on 2026-04-16T05:16:24.090Z.
-Source: swarm/mealie.yaml
+<Written by Gremlin on 2026-04-16T05:19:15.312Z>
+Generated from swarm/mealie.yaml
 Review User Guide and Changelog sections
\ No newline at end of file