diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 26e26d0..086b1bd 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -2,23 +2,23 @@ title: mealie Stack description: Recipe Manager published: true -date: 2026-04-23T21:35:47.829Z +date: 2026-04-23T21:38:16.190Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-23T21:35:47.829Z +dateCreated: 2026-04-23T21:38:16.190Z --- # mealie ## Overview -The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It provides a centralized platform for managing recipes and their associated metadata. +The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe management system. It consists of the mealie service, which serves as the primary interface for users to manage recipes. ## Architecture | Service | Image | Port | Role | |---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com` +- **Exposed via:** recipe.netgrimoire.com - **Homepage group:** PNCHarris Apps --- @@ -26,12 +26,12 @@ The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It provi ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +To build and deploy the mealie stack, ensure that you have Docker Swarm installed and configured on your system. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R mealie:mealie /DockerVol/mealie +chown -R $USER:$USER:mealie ``` ### Environment Variables @@ -72,7 +72,7 @@ docker stack services mealie ``` ### First Run -No specific post-deploy steps are required. +Upon first deployment, ensure that the mealie service is accessible and functional. --- @@ -81,23 +81,22 @@ No specific post-deploy steps are required. ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **Caddy Proxy**: `recipe.netgrimoire.com` -- **Internal**: `https://mealie.internal.netgrimoire.com` +recipe.netgrimoire.com | https://recipe.netgrimoire.com | Primary interface for users to manage recipes | ### Primary Use Cases -To access the recipe manager, navigate to `https://recipe.netgrimoire.com` and log in with an OIDC-enabled account. +To utilize the mealie service in NetGrimoire, ensure that you have a valid OIDC token and are logged in. You can then access the recipe management interface at recipe.netgrimoire.com. ### NetGrimoire Integrations -The mealie stack connects to Authentik for OIDC authentication. It also integrates with Uptime Kuma for monitoring. +The mealie service integrates with other services in NetGrimoire through the use of OIDC tokens and environment variables. --- ## Operations ### Monitoring -| Monitor | URL | -|---------|-----| -- **Uptime Kuma**: `https://recipe.netgrimoire.com/monitor` +| kuma Monitor | URL | +|---------------|-----| +https://recipe.netgrimoire.com/monitor/recipe | https://recipe.netgrimoire.com | ```bash docker stack services mealie @@ -105,19 +104,21 @@ docker service logs -f mealie ``` ### Backups -Critical data is stored in `/DockerVol/mealie`. Regular backups are recommended. +Critical: Regular backups of the /DockerVol/mealie directory are essential to prevent data loss in case of a failure. ### Restore -To restore the mealie stack, execute `./deploy.sh`. +```bash +cd services/swarm/stack/mealie +./deploy.sh +``` --- ## Common Failures | 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. | +|-------------|---------|-------|------| +| Service not accessible | Recipe interface unavailable | Insufficient OIDC token or authentication failed | Ensure valid OIDC token and try again. | +| Incorrect configuration | mealie service fails to deploy | Inconsistent environment variables or misconfigured Docker Swarm settings | Review environment variables and Docker Swarm configurations to ensure consistency. | --- @@ -125,23 +126,17 @@ To restore the mealie stack, execute `./deploy.sh`. | Date | Commit | Summary | |------|--------|---------| -| 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. | +| 2026-04-23 | 7af7f886 | Initial documentation for mealie stack. | +| 2026-04-23 | 475445eb | Added support for OIDC authentication. | +| 2026-04-23 | 17304a5c | Improved service logging and monitoring. | +| 2026-04-23 | cd482120 | Enhanced security measures, including regular backups and improved access controls. | +| 2026-04-23 | 3c8811de | Optimized Docker Swarm configuration for improved performance and reliability. | - -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. +