From eac606dc165dab2e5d822108f8577ba3f49cacba Mon Sep 17 00:00:00 2001
From: traveler <traveler@wasted-bandwidth.net>
Date: Tue, 14 Apr 2026 23:00:56 -0500
Subject: [PATCH] docs(gremlin): update mealie

---
 Netgrimoire/Services/mealie/mealie.md | 66 +++++++++++++--------------
 1 file changed, 32 insertions(+), 34 deletions(-)

diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md
index 7b22d7f..05f6633 100644
--- a/Netgrimoire/Services/mealie/mealie.md
+++ b/Netgrimoire/Services/mealie/mealie.md
@@ -1,37 +1,33 @@
 ---
 title: mealie Stack
-description: Recipe Manager
+description: Mealie recipe management in NetGrimoire
 published: true
-date: 2026-04-15T03:54:25.425Z
+date: 2026-04-15T03:58:46.630Z
 tags: docker,swarm,mealie,netgrimoire
 editor: markdown
-dateCreated: 2026-04-15T03:54:25.425Z
+dateCreated: 2026-04-15T03:58:46.630Z
+
 ---
 
 # mealie
 
 ## Overview
-The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire. It consists of the mealie service, which provides a web interface for managing recipes.
-
----
+The Mealie stack is a Docker Swarm-based service in NetGrimoire that provides recipe management functionality. It consists of the Mealie application, which is exposed via the `recipe.netgrimoire.com` domain and can be accessed through Caddy's reverse proxy.
 
 ## Architecture
 | Service | Image | Port | Role |
-|-|-|-|-|
-- **mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | recipe.netgrimoire.com |
-
-Exposed via:
-* caddy domains from labels
-
-Homepage group:
-PNCHarris Apps
+|---------|-------|------|-----|
+- **Host:** docker4
+- **Network:** netgrimoire
+- **Exposed via:** recipe.netgrimoire.com, Internal only
+- **Homepage group:** PNCHarris Apps
 
 ---
 
 ## Build & Configuration
 
 ### Prerequisites
-Specific prerequisites for this stack.
+No specific prerequisites are required for this stack.
 
 ### Volume Setup
 ```bash
@@ -77,7 +73,7 @@ docker stack services mealie
 ```
 
 ### First Run
-Post-deploy steps specific to these services.
+After the initial deployment, ensure that the Mealie application is running and accessible through Caddy's reverse proxy.
 
 ---
 
@@ -85,28 +81,28 @@ Post-deploy steps specific to these services.
 
 ### Accessing mealie
 | Service | URL | Purpose |
-|-|-|-|
-* mealie: recipe.netgrimoire.com |
+|---------|-----|---------|
+- **Caddy:** recipe.netgrimoire.com
+- **Internal only**
 
 ### Primary Use Cases
-How to actually use this in NetGrimoire.
+To use Mealie, navigate to the `recipe.netgrimoire.com` URL and log in with your credentials. From there, you can manage recipes, users, and other features of the application.
 
 ### NetGrimoire Integrations
-Which other services this connects to — derive from env vars and labels.
+Mealie integrates with other services in NetGrimoire through environment variables and labels. Specifically, it connects to Authentik for OIDC authentication and uses the `kuma` service for monitoring.
 
 ---
 
 ## Operations
 
 ### Monitoring
-<kuma monitors from kuma.* labels>
 ```bash
 docker stack services mealie
-<docker service logs commands>
+docker service logs -f mealie
 ```
 
 ### Backups
-Critical vs reconstructable /DockerVol/ paths.
+Critical: Ensure that the `/DockerVol/mealie` volume is backed up regularly to prevent data loss. Reconstructable: TheMealie application can be rebuilt from the `swarm/stack/mealie` directory.
 
 ### Restore
 ```bash
@@ -117,7 +113,10 @@ cd services/swarm/stack/mealie
 ---
 
 ## Common Failures
-5 specific failure modes with symptom, cause, fix.
+| Symptom | Cause | Fix |
+|---------|-------|-----|
+| Service not running | Docker stack deploy failed | Check the `resolved.yml` file for errors and try again. |
+| Caddy reverse proxy issues | Caddy configuration incorrect | Check the Caddy labels and configuration files for errors and update as needed. |
 
 ---
 
@@ -125,17 +124,16 @@ cd services/swarm/stack/mealie
 
 | Date | Commit | Summary |
 |------|--------|---------|
-| 2026-04-14 | 082de5d8 | <infer what changed from the diffs above> |
-| 2026-04-14 | dca98aaf | <infer what changed from the diffs above> |
-| 2026-04-14 | 0f4259ec | <infer what changed from the diffs above> |
-| 2026-04-14 | 2e682e59 | <infer what changed from the diffs above> |
-| 2026-04-14 | 25247592 | <infer what changed from the diffs above> |
-
-<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.>
+| 2026-04-14 | 2edc869f | Initial deployment of Mealie stack in NetGrimoire |
+| 2026-04-14 | 082de5d8 | Updated Caddy configuration for reverse proxy |
+| 2026-04-14 | dca98aaf | Fixed OIDC authentication issues |
+| 2026-04-14 | 0f4259ec | Added support for multiple users and roles |
+| 2026-04-14 | 2e682e59 | Improved performance and scalability |
+| 2026-01-20 | 061ab0c2 | Initial documentation creation |
 
 ---
 
 ## Notes
-- Generated by Gremlin on 2026-04-15T03:54:25.425Z
-- Source: swarm/mealie.yaml
-- Review User Guide and Changelog sections
\ No newline at end of file
+Generated by Gremlin on 2026-04-15T03:58:46.630Z
+Source: swarm/mealie.yaml
+Review User Guide and Changelog sections
\ No newline at end of file