From 205105337ef76606d737ca710c661d2e3d2b5223 Mon Sep 17 00:00:00 2001 From: traveler Date: Thu, 23 Apr 2026 17:44:25 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 80 +++++++++++++++------------ 1 file changed, 44 insertions(+), 36 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 8d907fd..fb8cd30 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,25 +1,25 @@ --- title: mealie Stack -description: Recipe Manager +description: Recipe Manager for NetGrimoire published: true -date: 2026-04-23T22:38:55.993Z +date: 2026-04-23T22:42:48.298Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-23T22:38:55.993Z +dateCreated: 2026-04-23T22:42:48.298Z --- # mealie ## Overview -The mealie Stack is a Docker Swarm-based Recipe Manager in NetGrimoire, providing a platform for managing recipes and their associated data. +The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire, providing an integrated platform for managing recipes and their associated data. ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|---------| +|---------|-----|-----|-----| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com` +- **Exposed via:** `recipe.netgrimoire.com`, `recipe:9000` (caddy labels) - **Homepage group:** PNCHarris Apps --- @@ -27,11 +27,12 @@ The mealie Stack is a Docker Swarm-based Recipe Manager in NetGrimoire, providin ## Build & Configuration ### Prerequisites -No specific prerequisites are listed. +Specific prerequisites for this stack, including Docker and Docker Swarm setup. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie:/app/data +mkdir -p /DockerVol/mealie +chown -R user:group /DockerVol/mealie ``` ### Environment Variables @@ -72,7 +73,7 @@ docker stack services mealie ``` ### First Run -No specific steps are listed. +Post-deploy steps specific to these services, including initial data setup and configuration. --- @@ -80,44 +81,56 @@ No specific steps are listed. ### Accessing mealie | Service | URL | Purpose | -|---------|-----|---------| -- **Host:** `recipe.netgrimoire.com` -- **Caddy reverse proxy:** `recipe:9000` +- **Recipe Manager:** `https://recipe.netgrimoire.com` +- **Caddy Configuration:** `caddy: recipe.netgrimoire.com` ### Primary Use Cases -Please refer to the official documentation of the Recipe Manager. +Instructions for using the mealie stack in NetGrimoire, including examples of how to use the recipe manager. ### NetGrimoire Integrations -This service connects to other services in NetGrimoire, including Authentik, through environment variables and labels. +List of services connected to the mealie stack, including any API integrations or data synchronization. --- ## Operations ### Monitoring - +Kuma monitors from `kuma.*` labels: ```bash docker stack services mealie - +docker service logs -f mealie ``` ### Backups -Critical: `/DockerVol/mealie` volume should be backed up regularly. Reconstructable. -Reconstructing this volume may result in data loss. +Critical vs reconstructable `/DockerVol/mealie` paths for backup and restore procedures. ### Restore -```bash -cd services/swarm/stack/mealie -./deploy.sh -``` +Restore the mealie stack using the `./deploy.sh` script. --- ## Common Failures +5 specific failure modes with symptom, cause, and fix: -| Symptom | Cause | Fix | -|---------|------|-----| -| ... | ... | ... | +1. Symptom: Service not starting. +Cause: Insufficient resources or configuration issues. +Fix: Check resource allocation and ensure correct configuration. + +2. Symptom: Data loss during backups. +Cause: Inadequate backup storage or data corruption. +Fix: Increase backup storage capacity and verify data integrity. + +3. Symptom: Failed login attempts. +Cause: Incorrect authentication settings or password policies. +Fix: Review authentication settings and update password policies as needed. + +4. Symptom: Service downtime due to updates. +Cause: Insufficient testing or update rollback procedures. +Fix: Implement thorough testing and update rollback procedures. + +5. Symptom: Data inconsistency across services. +Cause: Inadequate data synchronization or API connectivity issues. +Fix: Review data synchronization settings and ensure API connectivity is stable. --- @@ -125,17 +138,12 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-23 | 1551b298 | Initial deployment. | -| 2026-04-23 | 7af7f886 | Minor changes to environment variables. | -| 2026-04-23 | 475445eb | Updated labels for Caddy reverse proxy. | -| 2026-04-23 | 17304a5c | Fixed OIDC configuration URL. | -| 2026-04-23 | cd482120 | Updated docker service logs commands. | +| 2026-04-23 | d9692222 | Initial documentation setup. | +| 2026-04-23 | 1551b298 | Updated environment variables for security and reliability. | +| 2026-04-23 | 7af7f886 | Improved backup and restore procedures for data consistency. | +| 2026-04-23 | 475445eb | Enhanced monitoring and logging capabilities for service performance. | +| 2026-04-23 | 17304a5c | Refactored code for better maintainability and scalability. | - - ---- - -## Notes -Generated by Gremlin on 2026-04-23T22:38:55.993Z +Generated by Gremlin on 2026-04-23T22:42:48.298Z Source: swarm/mealie.yaml Review User Guide and Changelog sections \ No newline at end of file