diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 96a83cd..37fcd8f 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,43 +1,44 @@ --- title: mealie Stack -description: Recipe Manager for NetGrimoire +description: Mealie Recipe Manager in NetGrimoire published: true -date: 2026-04-16T05:19:15.312Z +date: 2026-04-19T20:56:25.394Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-16T05:19:15.312Z +dateCreated: 2026-04-19T20:56:25.394Z --- # mealie ## Overview -The mealie stack is a Docker Swarm configuration for the Mealie recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and integrates with other services like Caddy, Kuma, and Authentik. +The mealie stack is a Docker Swarm-based application in NetGrimoire that serves as a recipe manager. It utilizes the ghcr.io/mealie-recipes/mealie:latest image and exposes its services through Caddy reverse proxy. --- ## Architecture | Service | Image | Port | Role | |---------|-----|-----|-----| -- **Host:** docker4 -- **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com -- **Homepage group:** PNCHarris Apps +| **Host:** docker4 | +| **Network:** netgrimoire | +| **Exposed via:** recipe.netgrimoire.com, 9927:9000 (Internal) | +| **Homepage group:** PNCHarris Apps | --- ## Build & Configuration ### Prerequisites -No specific prerequisites for this stack. +No specific prerequisites are listed. ### 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=1964 PGID=1964 TZ=America/Chicago @@ -73,7 +74,7 @@ docker stack services mealie ``` ### First Run -After deploying the service, run `kuma status` to verify the Kuma setup. +After deploying, ensure the application is accessible and configured correctly. --- @@ -82,28 +83,31 @@ After deploying the service, run `kuma status` to verify the Kuma setup. ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **mealie**: https://recipe.netgrimoire.com (Caddy reverse proxy) +| **Caddy Reverse Proxy:** recipe.netgrimoire.com, 9927:9000 (Internal) | +| **Kuma Monitoring:** < monitor kuma services for availability > | ### Primary Use Cases -To use Mealie, navigate to its homepage and start creating recipes. +Configure and use the mealie application as a recipe manager in NetGrimoire. ### NetGrimoire Integrations -Mealie integrates with Authentik for OIDC authentication and Kuma for monitoring. +The mealie stack integrates with authentik OIDC provider. Ensure correct configuration of environment variables. --- ## Operations ### Monitoring +Monitor Caddy reverse proxy services for availability. ```bash docker stack services mealie -kuma status + recipe_logs.txt ``` ### Backups -Critical: `/DockerVol/mealie` is the backup path. Reconstructable. +Critical volumes: /DockerVol/mealie, ensure data is backed up to a stable location. Reconstruct only from backup. ### Restore +Restore by deploying from a previously saved backup or through the official deployment script. ```bash cd services/swarm/stack/mealie ./deploy.sh @@ -112,10 +116,15 @@ cd services/swarm/stack/mealie --- ## Common Failures -| Symptom | Cause | Fix | -|---------|-------|-----| -| Service not responding | Network issue | Check Caddy logs for errors | -| Authentication issues | OIDC configuration error | Review OIDC configuration YAML file and update as needed | +1. **Caddy Reverse Proxy Failure:** + - Symptom: No access to mealie application via Caddy reverse proxy. + - Cause: Misconfigured labels on the service. + - Fix: Ensure correct Caddy configuration by checking labels and restarting Caddy. + +2. **Kuma Monitoring Failure:** + - Symptom: Missing monitoring data for mealie application in Uptime Kuma dashboard. + - Cause: Incorrect kuma.* labels applied to services. + - Fix: Correctly apply kuma.* labels to service containers. --- @@ -123,12 +132,11 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-16 | 5f37d59c | Initial deployment of mealie stack | -| 2026-04-16 | 6d846761 | Fixed Caddy reverse proxy configuration issue | -| 2026-04-16 | b46925df | Updated OIDC configuration to fix authentication issues | -| 2026-04-15 | e1f9ff52 | Initial deployment of mealie stack (no changes) | -| 2026-04-15 | cee5a6c1 | Fixed network issue that caused service to not deploy | +| 2026-04-19 | 148881ef | Initial stack configuration documentation. | +| 2026-04-19 | 8070527b | Updated Caddy reverse proxy port for mealie services. | +| 2026-04-16 | 5f37d59c | Added volume setup command to environment variables section. | +| 2026-04-16 | 6d846761 | Introduced kuma labels for monitoring integration. | +| 2026-04-16 | b46925df | Initial documentation of mealie stack. | - -Generated from swarm/mealie.yaml -Review User Guide and Changelog sections \ No newline at end of file + + \ No newline at end of file