diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index dbac7e4..7b22d7f 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,40 +1,42 @@ --- title: mealie Stack -description: Mealie Recipe Manager for NetGrimoire +description: Recipe Manager published: true -date: 2026-04-15T03:46:23.992Z +date: 2026-04-15T03:54:25.425Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-15T03:46:23.992Z - +dateCreated: 2026-04-15T03:54:25.425Z --- # mealie ## Overview -The mealie Stack is a Docker Swarm-based service for the Recipe Manager component in NetGrimoire. It provides a centralized platform for recipe management, featuring user authentication, group management, and recipe storage. +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. --- ## Architecture | Service | Image | Port | Role | -|---------|-------|------|------| -- **Host:** docker4 -- **Network:** netgrimoire -- **Exposed via:** `caddy:recipe.netgrimoire.com` -- **Homepage group:** PNCHarris Apps +|-|-|-|-| +- **mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | recipe.netgrimoire.com | + +Exposed via: +* caddy domains from labels + +Homepage group: +PNCHarris Apps --- ## Build & Configuration ### Prerequisites -This stack requires the mealie image and Docker Swarm configuration. +Specific prerequisites for this stack. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R user:group /DockerVol/mealie +chown -R mealie:mealie /DockerVol/mealie ``` ### Environment Variables @@ -75,7 +77,7 @@ docker stack services mealie ``` ### First Run -This service does not require a specific first-run process. +Post-deploy steps specific to these services. --- @@ -83,28 +85,28 @@ This service does not require a specific first-run process. ### Accessing mealie | Service | URL | Purpose | -|---------|-----|---------| -- **Caddy reverse proxy:** recipe.netgrimoire.com:9000 +|-|-|-| +* mealie: recipe.netgrimoire.com | ### Primary Use Cases -Use the Recipe Manager to manage recipes, user authentication, and group management in NetGrimoire. +How to actually use this in NetGrimoire. ### NetGrimoire Integrations -This service integrates with other services through environment variables and Docker Swarm labels. +Which other services this connects to — derive from env vars and labels. --- ## Operations ### Monitoring -[kuma monitors from kuma.* labels] + ```bash docker stack services mealie ``` ### Backups -Critical backups are required for critical data. The /DockerVol/mealie path should be backed up regularly. +Critical vs reconstructable /DockerVol/ paths. ### Restore ```bash @@ -115,10 +117,7 @@ cd services/swarm/stack/mealie --- ## Common Failures -| Symptom | Cause | Fix | -|---------|-------|-----| -- Mealie not accessible | Incorrect Caddy configuration | Check Caddy labels and verify the reverse proxy is correct. -- Recipe management issues | Environment variables not set correctly | Verify environment variables are set correctly in the .env file. +5 specific failure modes with symptom, cause, fix. --- @@ -126,12 +125,17 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-14 | dca98aaf | Initial documentation | -| 2026-04-14 | 0f4259ec | Initial configuration | -| 2026-04-14 | 2e682e59 | Initial deployment script | -| 2026-04-14 | 25247592 | Initial environment variables | -| 2026-04-14 | b7b2ae6e | Initial Caddy reverse proxy setup | +| 2026-04-14 | 082de5d8 | | +| 2026-04-14 | dca98aaf | | +| 2026-04-14 | 0f4259ec | | +| 2026-04-14 | 2e682e59 | | +| 2026-04-14 | 25247592 | | -Generated by Gremlin on 2026-04-15T03:46:23.992Z -Source: swarm/mealie.yaml -Review User Guide and Changelog sections \ No newline at end of file + + +--- + +## 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