diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 78aae0e..dbac7e4 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,16 +1,27 @@ +--- +title: mealie Stack +description: Mealie Recipe Manager for NetGrimoire +published: true +date: 2026-04-15T03:46:23.992Z +tags: docker,swarm,mealie,netgrimoire +editor: markdown +dateCreated: 2026-04-15T03:46:23.992Z + +--- + # mealie ## Overview -The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe manager for managing recipes. It consists of the Mealie application, which handles recipe management tasks. +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. --- ## Architecture | Service | Image | Port | Role | -|- **Mealie** | ghcr.io/mealie-recipes/mealie:latest | 9000 | Application | - -- **Exposed via:** recipe.netgrimoire.com - +|---------|-------|------|------| +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** `caddy:recipe.netgrimoire.com` - **Homepage group:** PNCHarris Apps --- @@ -18,16 +29,12 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a ## Build & Configuration ### Prerequisites -The mealie stack requires the following prerequisites: -* Docker Swarm manager and worker roles set up -* Caddy reverse proxy configuration -* Uptime Kuma monitoring setup -* Homepage labels applied +This stack requires the mealie image and Docker Swarm configuration. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R docker4:docker4 /DockerVol/mealie +chown -R user:group /DockerVol/mealie ``` ### Environment Variables @@ -68,7 +75,7 @@ docker stack services mealie ``` ### First Run -Perform any necessary post-deploy steps, such as initializing database or setting up initial data. +This service does not require a specific first-run process. --- @@ -76,28 +83,28 @@ Perform any necessary post-deploy steps, such as initializing database or settin ### Accessing mealie | Service | URL | Purpose | -|- **Mealie** | https://recipe.netgrimoire.com | Recipe Manager | +|---------|-----|---------| +- **Caddy reverse proxy:** recipe.netgrimoire.com:9000 ### Primary Use Cases -Configure Mealie to manage recipes for specific use cases, such as user authentication and recipe categorization. +Use the Recipe Manager to manage recipes, user authentication, and group management in NetGrimoire. ### NetGrimoire Integrations -Connect Mealie to other services in NetGrimoire, such as authentik or crowdsec, to enable integrations like OAuth authentication and security scanning. +This service integrates with other services through environment variables and Docker Swarm labels. --- ## Operations ### Monitoring -*kuma monitors from kuma.* labels* - +[kuma monitors from kuma.* labels] ```bash docker stack services mealie ``` ### Backups -Critical vs reconstructable /DockerVol/ paths. +Critical backups are required for critical data. The /DockerVol/mealie path should be backed up regularly. ### Restore ```bash @@ -109,8 +116,9 @@ cd services/swarm/stack/mealie ## Common Failures | Symptom | Cause | Fix | -|- **Mealie crashes with 500 error** | Insufficient resources on worker node | Increase worker resources or scale up worker nodes | -|- **Recipe data lost after update** | Missing backups | Regularly run backups and restore from backup in case of failure | +|---------|-------|-----| +- 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. --- @@ -118,13 +126,12 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-14 | 0f4259ec | Initial documentation | -| 2026-04-14 | 2e682e59 | Added Caddy reverse proxy configuration | -| 2026-04-14 | 25247592 | Configured Uptime Kuma monitoring | -| 2026-04-14 | b7b2ae6e | Set up Homepage labels | -| 2026-04-14 | 0520af76 | Improved recipe data storage | -| 2026-04-14 | 49688e1c | Fixed security vulnerability in Mealie application | +| 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 | -Generated by Gremlin on 2026-04-15T03:42:32.767Z +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