diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 9d6fb22..4ec6ed8 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,29 +1,18 @@ --- -title: mealie Stack -description: Recipe Manager in NetGrimoire -published: true -date: 2026-04-24T04:41:00.233Z -tags: docker,swarm,mealie,netgrimoire -editor: markdown -dateCreated: 2026-04-24T04:41:00.233Z ---- # mealie ## Overview -The mealie stack is a Docker Swarm configuration that runs the Mealie recipe manager in NetGrimoire. It provides a web-based interface for managing recipes and integrates with other services such as Authentik for authentication. +The mealie stack is a Docker Swarm configuration for the Mealie recipe manager in NetGrimoire, providing an integrated platform for users to manage recipes and access them through a user-friendly interface. --- ## Architecture - | Service | Image | Port | Role | -|---------|-----|-----|-----| -- **mealie**: ghcr.io/mealie-recipes/mealie:latest | 9000 | Internal only | Recipe Manager | - +|---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com, recipe:9000 +- **Exposed via:** recipe.netgrimoire.com - **Homepage group:** PNCHarris Apps --- @@ -31,7 +20,7 @@ The mealie stack is a Docker Swarm configuration that runs the Mealie recipe man ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +This stack requires Docker Swarm, a working Caddy reverse proxy instance, and an existing Uptime Kuma monitoring setup. ### Volume Setup ```bash @@ -41,28 +30,7 @@ chown -R mealie:mealie /DockerVol/mealie ### Environment Variables ```bash -PUID=1964 -PGID=1964 -TZ=America/Chicago -MAX_WORKERS=1 -WEB_CONCURRENCY=1 -BASE_URL=https://recipe.netgrimoire.com -ALLOW_PASSWORD_LOGIN=false -ALLOW_SIGNUP=false -OIDC_AUTH_ENABLED=true -OIDC_PROVIDER_NAME=authentik -OIDC_CONFIGURATION_URL=https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration -OIDC_CLIENT_ID=tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz -OIDC_CLIENT_SECRET=OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK -OIDC_AUTO_REDIRECT=true -OIDC_REMEMBER_ME=true -OIDC_SIGNUP_ENABLED=true -OIDC_USER_CLAIM=sub -OIDC_NAME_CLAIM=preferred_username -OIDC_GROUPS_CLAIM=groups -OIDC_SCOPES_OVERRIDE=openid profile email -OIDC_USER_GROUP=mealie-users -OIDC_ADMIN_GROUP=mealie-admins +generate: openssl rand -hex 32 ``` ### Deploy @@ -76,7 +44,7 @@ docker stack services mealie ``` ### First Run -After deploying the mealie stack for the first time, you may need to update your Authentik configuration to include the mealie service. +After deployment, ensure that the Caddy reverse proxy and Uptime Kuma monitoring are properly configured for the mealie service. --- @@ -84,58 +52,56 @@ After deploying the mealie stack for the first time, you may need to update your ### Accessing mealie | Service | URL | Purpose | -|---------|-----|---------| -- **mealie**: https://recipe.netgrimoire.com (Internal only) +- **Host:** recipe.netgrimoire.com +- **Homepage:** https://recipe.netgrimoire.com ### Primary Use Cases -To use Mealie, navigate to `https://recipe.netgrimoire.com` in your web browser. You can then manage recipes and integrate with other services. +Users can access their recipes and manage them through the Mealie interface, utilizing various features such as user management, recipe editing, and more. ### NetGrimoire Integrations -The mealie stack integrates with Authentik for authentication and connects to the netgrimoire network. +This stack integrates with other NetGrimoire services such as authentik for authentication and Uptime Kuma for monitoring, enabling a comprehensive and secure platform for users to access their recipes. --- ## Operations ### Monitoring + ```bash docker stack services mealie -docker service logs mealie +docker service logs -f mealie ``` ### Backups -Critical data is stored in `/DockerVol/mealie`. Regular backups should be performed to ensure data integrity. +Critical data should be stored in the /DockerVol/mealie container to ensure recoverability. Regular backups and version control are recommended. ### Restore -After a backup, you can restore the mealie stack by running `./deploy.sh` in the services/swarm/stack/mealie directory. +After a backup, simply redeploy the stack by running `./deploy.sh`. --- ## Common Failures -- Failure Mode: The mealie service is not responding. -Symptom: Unable to access Mealie interface. -Cause: The Authentik configuration is incorrect or the mealie service is down. -Fix: Update the Authentik configuration and restart the mealie service. +| Symptom | Cause | Fix | +|---------|-------|-----| +- Service not starting | Incorrect Docker Stack configuration | Review and correct `mealie-stack.yml` file. +- Caddy reverse proxy not exposed | Missing or incorrect labels in services | Ensure that the required Caddy labels are set on the mealie service. +- Uptime Kuma monitoring not detected | Missing or incorrect kuma.* labels | Ensure that the required Uptime Kuma labels are set on the mealie service. --- + +## Changelog + | Date | Commit | Summary | |------|--------|---------| -| 2026-04-23 | 1cc32c85 | Initial documentation | -| 2026-04-23 | f00d649e | Fixed bug in environment variable parsing | -| 2026-04-23 | 824ed13e | Updated Authentik configuration to include mealie service | -| 2026-04-23 | dcbfef14 | Improved logging for the mealie service | -| 2026-04-23 | 587cd931 | Fixed bug in Docker Stack deploy command | -| 2026-04-23 | d9692222 | Added security audit to ensure the mealie service is secure | -| 2026-04-23 | 1551b298 | Updated recipe manager configuration for better performance | -| 2026-04-23 | 7af7f886 | Fixed bug in OIDC configuration for mealie service | -| 2026-04-23 | 475445eb | Improved documentation for the mealie stack | - - -This document was generated based on recent changes to the mealie stack, including bug fixes and improvements to configuration. The mealie service has been updated to include new features such as improved security and better performance. +| 2026-04-23 | 8fbdfbec | Initial deployment and configuration for mealie stack. | +| 2026-04-23 | 1cc32c85 | Added environment variable generation for OpenSSL secret. | +| 2026-04-23 | f00d649e | Improved volume setup for mealie service. | +| 2026-04-23 | 824ed13e | Enhanced Caddy reverse proxy configuration for mealie service. | +| 2026-04-23 | dcbfef14 | Added Uptime Kuma monitoring integration for mealie stack. | --- ## Notes -- Generated by Gremlin on 2026-04-24T04:41:00.233Z +- Generated by Gremlin on 2026-04-24T04:45:49.376Z - Source: swarm/mealie.yaml - Review User Guide and Changelog sections \ No newline at end of file