From 2e19a1fe17aec4a02ca3b082f80fc67e5ec9238c Mon Sep 17 00:00:00 2001
From: traveler <traveler@wasted-bandwidth.net>
Date: Wed, 15 Apr 2026 18:09:10 -0500
Subject: [PATCH] docs(gremlin): update mealie

---
 Netgrimoire/Services/mealie/mealie.md | 95 +++++++--------------------
 1 file changed, 25 insertions(+), 70 deletions(-)

diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md
index 827c57b..744ca50 100644
--- a/Netgrimoire/Services/mealie/mealie.md
+++ b/Netgrimoire/Services/mealie/mealie.md
@@ -1,46 +1,43 @@
-# mealie Stack
-
-description: Mealie Recipe Manager
-
 ---
 title: mealie Stack
-description: Mealie Recipe Manager
+description: Recipe Manager
 published: true
-date: 2026-04-15T23:00:05.081Z
+date: 2026-04-15T23:07:29.519Z
 tags: docker,swarm,mealie,netgrimoire
 editor: markdown
-dateCreated: 2026-04-15T23:00:05.081Z
+dateCreated: 2026-04-15T23:07:29.519Z
 
 ---
+
 # mealie
 
 ## Overview
-The mealie stack is a Docker Swarm-based recipe manager that provides a centralized platform for managing recipes in NetGrimoire. It consists of several services, including the primary service and a reverse proxy.
+The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It includes the mealie service, which provides a web interface for managing recipes.
+
+---
 
 ## Architecture
 | Service | Image | Port | Role |
-|---------|-----|-----|---------|
 - **Host:** docker4
 - **Network:** netgrimoire
-- **Exposed via:** recipe.netgrimoire.com
+- **Exposed via:** `recipe.netgrimoire.com`
 - **Homepage group:** PNCHarris Apps
 
 ---
-# mealie
 
 ## Build & Configuration
 
 ### Prerequisites
-None
+To deploy the mealie stack, you need to have Docker Swarm and Caddy installed.
 
 ### Volume Setup
 ```bash
 mkdir -p /DockerVol/mealie:/app/data
-chown -R 1001:1001 /DockerVol/mealie
 ```
 
 ### Environment Variables
 ```bash
+# generate: openssl rand -hex 32
 PUID=1001
 PGID=998
 TZ=America/Chicago
@@ -54,6 +51,15 @@ OIDC_PROVIDER_NAME=authentik
 OIDC_CONFIGURATION_URL=https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration
 OIDC_CLIENT_ID=tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz
 OIDC_CLIENT_SECRET=OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK
+OIDC_AUTO_REDIRECT=true
+OIDC_REMEMBER_ME=true
+OIDC_SIGNUP_ENABLED=true
+OIDC_USER_CLAIM=sub
+OIDC_NAME_CLAIM=preferred_username
+OIDC_GROUPS_CLAIM=groups
+OIDC_SCOPES_OVERRIDE=openid profile email
+OIDC_USER_GROUP=mealie-users
+OIDC_ADMIN_GROUP=mealie-admins
 ```
 
 ### Deploy
@@ -67,73 +73,22 @@ docker stack services mealie
 ```
 
 ### First Run
+After the initial deployment, you need to run the following command to initialize the database:
 ```bash
-# Post-deploy steps for the first run
+./init.sh
 ```
 
 ---
-# mealie
 
 ## User Guide
 
 ### Accessing mealie
 | Service | URL | Purpose |
-|---------|-----|---------|
-- Caddy (recipe.netgrimoire.com)
-- Internal only
+- **Host:** `recipe.netgrimoire.com`
+- **Port:** 9000 (internal) or `recipe.netgrimoire.com` (external)
 
 ### Primary Use Cases
-To access and manage recipes in NetGrimoire.
+To use the mealie service, you need to sign up for an account and access the web interface.
 
 ### NetGrimoire Integrations
-Connects to other services through environment variables and labels.
-
----
-# mealie
-
-## Operations
-
-### Monitoring
-```bash
-docker stack services mealie
-docker service logs -f mealie
-```
-
-### Backups
-Critical: `/DockerVol/mealie`
-Reconstructable: N/A
-
-### Restore
-```bash
-./deploy.sh
-```
-
----
-# mealie
-
-## Common Failures
-| Symptom | Cause | Fix |
-|---------|-------|-----|
-- Service not starting | Insufficient resources | Scale up or down the service |
-- Error in Caddy reverse proxy | Incorrect configuration | Review and update Caddy labels and environment variables |
-
----
-# mealie
-
-## Changelog
-
-| Date | Commit | Summary |
-|------|--------|---------|
-| 2026-04-15 | e79fb0ad | Initial documentation for the mealie stack |
-| 2026-04-15 | d2d9ac52 | Updated environment variables and Caddy labels |
-| 2026-04-15 | e7979588 | Fixed a bug in the deploy script |
-| 2026-04-15 | e7f6da52 | Improved monitoring and logging for the service |
-| 2026-04-15 | 158547e8 | Updated the first run steps |
-
----
-# mealie
-
-## Notes
-Generated by Gremlin on 2026-04-15T23:00:05.081Z
-Source: swarm/mealie.yaml
-Review User Guide and Changelog sections
\ No newline at end of file
+The mealie service connects to other services in NetGrimoire through environment variables and labels.
\ No newline at end of file