From a77e44396e00af74ffe3f465bf396f683db7ec03 Mon Sep 17 00:00:00 2001
From: traveler <traveler@wasted-bandwidth.net>
Date: Wed, 15 Apr 2026 21:44:11 -0500
Subject: [PATCH] docs(gremlin): update mealie

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

diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md
index f5c9406..26992b6 100644
--- a/Netgrimoire/Services/mealie/mealie.md
+++ b/Netgrimoire/Services/mealie/mealie.md
@@ -1,27 +1,28 @@
 ---
 title: mealie Stack
-description: Recipe Manager
+description: Recipe Manager for NetGrimoire
 published: true
-date: 2026-04-16T02:21:29.671Z
+date: 2026-04-16T02:42:01.339Z
 tags: docker,swarm,mealie,netgrimoire
 editor: markdown
-dateCreated: 2026-04-16T02:21:29.671Z
+dateCreated: 2026-04-16T02:42:01.339Z
 ---
 
 # mealie
 
 ## Overview
-The mealie stack provides a recipe management service in NetGrimoire. It includes services such as Caddy for reverse proxying and Uptime Kuma for monitoring. The primary service provided by this stack is the Mealie recipe manager.
+The mealie stack is a Recipe Manager service for NetGrimoire, providing a web-based interface to manage recipes and access recipe-related data.
 
+---
 ## Architecture
 | Service | Image | Port | Role |
+|---------|-------|------|-------|
 - **Host:** docker4
 - **Network:** netgrimoire
-- **Exposed via:** recipe.netgrimoire.com, 9000
+- **Exposed via:** `recipe.netgrimoire.com`, `caddy:9000`
 - **Homepage group:** PNCHarris Apps
 
 ---
-
 ## Build & Configuration
 
 ### Prerequisites
@@ -30,11 +31,12 @@ No specific prerequisites are required for this stack.
 ### Volume Setup
 ```bash
 mkdir -p /DockerVol/mealie
-chown -R mealie:mealie /DockerVol/mealie
+chown -R 1001:1001 /DockerVol/mealie
 ```
 
 ### Environment Variables
-```
+```bash
+# generate: openssl rand -hex 32
 PUID=1001
 PGID=998
 TZ=America/Chicago
@@ -70,25 +72,27 @@ docker stack services mealie
 ```
 
 ### First Run
-No specific post-deploy steps are required.
+After deploying the service, ensure that all necessary environment variables are set and the database is up-to-date.
 
 ---
-
 ## User Guide
 
 ### Accessing mealie
 | Service | URL | Purpose |
-- Caddy: recipe.netgrimoire.com, 9000
-- Uptime Kuma: kuma.recipe.http.name=Mealie, https://recipe.netgrimoire.com
+|---------|-----|---------|
+- **Caddy Reverse Proxy:** `recipe.netgrimoire.com`, `caddy:9000`
+- **Uptime Kuma Monitoring:** `kuma.recipe.http.name=Mealie` [link to monitoring dashboard]
 
 ### Primary Use Cases
-To access the Mealie recipe manager, navigate to the provided URL in a web browser. The primary use case for this service is managing recipes.
+To use the mealie stack, navigate to `https://recipe.netgrimoire.com` and log in with your credentials.
 
 ### NetGrimoire Integrations
-This service connects to Authentik and CrowdSec through environment variables and labels.
+The mealie stack integrates with other services through environment variables and labels, including:
+
+*   Authentik for OIDC authentication
+*   Uptime Kuma for monitoring
 
 ---
-
 ## Operations
 
 ### Monitoring
@@ -98,7 +102,7 @@ docker service logs -f mealie
 ```
 
 ### Backups
-The `/DockerVol/mealie` directory is critical for backup purposes. Critical vs reconstructable backups are recommended due to the sensitive nature of this service's data.
+Critical: Regular backups of the database and application data are necessary to prevent data loss.
 
 ### Restore
 ```bash
@@ -107,12 +111,14 @@ cd services/swarm/stack/mealie
 ```
 
 ---
-
 ## Common Failures
-| Symptom | Cause | Fix |
-- Service does not start.
-  - Cause: Caddy or Uptime Kuma not running.
-  - Fix: Check the service logs and restart the services if necessary.
+| Failure Mode | Symptoms | Cause | Fix |
+|-------------|----------|------|-----|
+| Service Not Responding | Service is not responding. | Insufficient resources or container restart required. | Restart service `docker service restart mealie` |
+
+| Database Issues | Data loss or inconsistencies in the database. | Critical: Regular backups are necessary to prevent data loss. | Check database logs and ensure regular backups are in place.|
+
+| Caddy Configuration Error | Caddy is not configured correctly, leading to broken URLs or other issues. | Insufficient configuration options or incorrect settings. | Review Caddy configuration and update as needed.
 
 ---
 
@@ -120,12 +126,13 @@ cd services/swarm/stack/mealie
 
 | Date | Commit | Summary |
 |------|--------|---------|
-| 2026-04-15 | 52bc39f9 | Initial commit with swarm configuration. |
-| 2026-04-15 | b490ae5d | Added environment variables for authentication. |
-| 2026-04-15 | 89277943 | Fixed Caddy reverse proxy to point to the correct URL. |
-| 2026-04-15 | 765f47e1 | Added Uptime Kuma monitoring configuration. |
-| 2026-04-15 | 9bed890d | Updated environment variables for new authentik configuration. |
+| 2026-04-15 | b9007e9e | Initial documentation for mealie stack |
 
-Generated by Gremlin on 2026-04-16T02:21:29.671Z
-Source: swarm/mealie.yaml
-Review User Guide and Changelog sections
\ No newline at end of file
+<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-16T02:42:01.339Z
+- Source: swarm/mealie.yaml
+- Review User Guide and Changelog sections
\ No newline at end of file