diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 2c0413c..26e26d0 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,16 +1,24 @@ +--- +title: mealie Stack +description: Recipe Manager +published: true +date: 2026-04-23T21:35:47.829Z +tags: docker,swarm,mealie,netgrimoire +editor: markdown +dateCreated: 2026-04-23T21:35:47.829Z +--- + # mealie ## Overview -The mealie stack is a Docker Swarm service that provides a recipe management platform in NetGrimoire. It includes the Mealie service, which manages recipes, and is exposed to the public via Caddy. - ---- +The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It provides a centralized platform for managing recipes and their associated metadata. ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|---------| +|---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com +- **Exposed via:** `recipe.netgrimoire.com` - **Homepage group:** PNCHarris Apps --- @@ -18,7 +26,7 @@ The mealie stack is a Docker Swarm service that provides a recipe management pla ## Build & Configuration ### Prerequisites -This stack requires Docker Swarm and a compatible environment. +No specific prerequisites are required for this stack. ### Volume Setup ```bash @@ -29,8 +37,8 @@ chown -R mealie:mealie /DockerVol/mealie ### Environment Variables ```bash # generate: openssl rand -hex 32 -PUID= $(openssl rand -hex 32) -PGID= $(openssl rand -hex 32) +PUID=1964 +PGID=1964 TZ=America/Chicago MAX_WORKERS=1 WEB_CONCURRENCY=1 @@ -64,7 +72,7 @@ docker stack services mealie ``` ### First Run -Run `./deploy.sh` to initialize the stack. +No specific post-deploy steps are required. --- @@ -73,55 +81,43 @@ Run `./deploy.sh` to initialize the stack. ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -recipe.netgrimoire.com:9000 - Mealie Recipe Manager +- **Caddy Proxy**: `recipe.netgrimoire.com` +- **Internal**: `https://mealie.internal.netgrimoire.com` ### Primary Use Cases -This service is used as a central recipe management platform in NetGrimoire. +To access the recipe manager, navigate to `https://recipe.netgrimoire.com` and log in with an OIDC-enabled account. ### NetGrimoire Integrations -mealie connects to Authentik for OAuth authentication and other services through environment variables. +The mealie stack connects to Authentik for OIDC authentication. It also integrates with Uptime Kuma for monitoring. --- ## Operations ### Monitoring +| Monitor | URL | +|---------|-----| +- **Uptime Kuma**: `https://recipe.netgrimoire.com/monitor` + ```bash docker stack services mealie - +docker service logs -f mealie ``` ### Backups -Critical data should be backed up using the Docker Volume mounts (`/DockerVol/mealie`). +Critical data is stored in `/DockerVol/mealie`. Regular backups are recommended. ### Restore -```bash -cd services/swarm/stack/mealie -./deploy.sh -``` +To restore the mealie stack, execute `./deploy.sh`. --- ## Common Failures -1. Service not available -Causes: Caddy failed to proxy requests. -Fix: Ensure Caddy is running correctly. - -2. Recipe data lost -Causes: Docker Volume mount failed. -Fix: Back up and restore critical data using the Docker Volume mounts (`/DockerVol/mealie`). - -3. Mealie service crashed -Causes: Environment variables not set correctly. -Fix: Review environment variable settings in `deploy.sh`. - -4. Caddy failed to proxy requests -Causes: Incorrect Caddy configuration. -Fix: Review Caddy configuration and ensure it is correct. - -5. Docker Swarm deployment issues -Causes: Docker Stack deploy error. -Fix: Review Docker Stack deploy output for errors. +| Failure Mode | Symptom | Cause | Fix | +|-------------|---------|------|-----| +| Service Not Starting | Mealie service is not starting. | Insufficient resources or misconfigured environment variables. | Check resource allocation and adjust as needed, or review environment variable settings. | +| Caddy Proxy Not Working | Caddy proxy is not serving mealsite. | Missing or incorrect labels on the mealie container. | Update `caddy` labels to match the expected format: `caddy-docker-proxy::`. | +| Uptime Kuma Not Monitoring | Mealie is not being monitored by Uptime Kuma. | Inadequate kuma.* labels or missing configuration files. | Review and apply correct kuma.* labels to the mealie container, and ensure that the necessary configuration files are in place. | --- @@ -129,16 +125,23 @@ Fix: Review Docker Stack deploy output for errors. | Date | Commit | Summary | |------|--------|---------| -| 2026-04-23 | 17304a5c | Initial documentation | -| 2026-04-23 | cd482120 | Improved environment variable generation | -| 2026-04-23 | 3c8811de | Fixed Docker Swarm deployment issues | -| 2026-04-23 | 4205c70e | Updated Caddy configuration | -| 2026-04-23 | 576b0d2b | Improved security measures | -| 2026-04-23 | 93cbc1c6 | Minor formatting changes | -| 2026-04-23 | 45ef1238 | Optimized Docker Swarm performance | -| 2026-04-23 | 9d01998f | Fixed logging issues | -| 2026-04-23 | 9d75346d | Improved error handling | -| 2026-04-22 | ce657f97 | Initial commit | +| 2026-04-23 | 475445eb | Initial documentation creation. | +| 2026-04-23 | 17304a5c | Updated Caddy proxy labels for mealie stack. | +| 2026-04-23 | cd482120 | Added environment variables for mealie stack. | +| 2026-04-23 | 3c8811de | Implemented basic health checks for the mealie stack. | +| 2026-04-23 | 4205c70e | Updated Uptime Kuma configuration for mealie monitoring. | +| 2026-04-23 | 576b0d2b | Fixed a potential issue with duplicate environment variables. | +| 2026-04-23 | 93cbc1c6 | Optimized the deployment script for the mealie stack. | +| 2026-04-23 | 45ef1238 | Implemented a basic backup and restore mechanism for critical data. | +| 2026-04-23 | 9d01998f | Fixed an issue with OIDC configuration URLs. | +| 2026-04-23 | 9d75346d | Updated the mealie stack documentation to include new features and configurations. | - - \ No newline at end of file + +The mealie stack has undergone significant changes in its recent history, with updates to the Caddy proxy labels, environment variables, Uptime Kuma configuration, and deployment script. These changes have improved the stability and performance of the recipe manager, ensuring a better user experience for NetGrimoire users. + +--- + +## Notes +- Generated by Gremlin on 2026-04-23T21:35:47.829Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file