diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 1da593e..eece191 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,27 +1,23 @@ --- + title: mealie Stack description: Recipe Manager for NetGrimoire -published: true -date: 2026-04-20T19:16:44.610Z -tags: docker,swarm,mealie,netgrimoire -editor: markdown -dateCreated: 2026-04-20T19:16:44.610Z --- - # mealie ## Overview -The mealie stack is a Docker Swarm-based service in NetGrimoire, providing a recipe manager for the community. It includes services such as Caddy and Uptime Kuma for reverse proxying and monitoring. +The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and integrates with other services such as Authentik and CrowdSec. --- ## Architecture + | Service | Image | Port | Role | -|---------|-----|-----|------| +|---------|-------|-----|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com` +- **Exposed via:** recipe:9000, recipe.netgrimoire.com (caddy labels) - **Homepage group:** PNCHarris Apps --- @@ -29,17 +25,39 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire, providing a rec ## Build & Configuration ### Prerequisites -This stack requires the mealie-stack.yml file to be generated with the correct environment variables and Docker configurations. +- Set up Docker Swarm manager and worker nodes with the required environment variables. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R 1001:1001 /DockerVol/mealie +chown -R user:group /DockerVol/mealie ``` ### Environment Variables ```bash -generate: openssl rand -hex 32 +# generate: openssl rand -hex 32 for secrets +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 ``` ### Deploy @@ -53,7 +71,7 @@ docker stack services mealie ``` ### First Run -After deploying, ensure that the services are healthy and Uptime Kuma is monitoring them. +- After the initial deployment, verify that the service is running correctly and update any necessary configuration files. --- @@ -62,39 +80,44 @@ After deploying, ensure that the services are healthy and Uptime Kuma is monitor ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- Caddy: `recipe.netgrimoire.com` -- Uptime Kuma: `https://kuma.netgrimoire.com` +- recipe:9000 (caddy labels) +- recipe.netgrimoire.com (Caddy reverse proxy) ### Primary Use Cases -This service provides a recipe manager for the NetGrimoire community. Users can access recipes, manage their accounts, and participate in discussions. +- Manage recipes and ingredients. +- Integrate with other NetGrimoire services. ### NetGrimoire Integrations -This service integrates with other NetGrimoire services, including Authentik and Crowdsec, using environment variables and labels. +- Authentik authentication and authorization. +- CrowdSec integration for security monitoring. --- ## Operations ### Monitoring -Uptime Kuma monitors the mealie stack for health and performance issues. Check `docker stack services mealie` for more information. +- Check the service logs using `docker stack services mealie`. ```bash docker stack services mealie docker service logs -f mealie ``` ### Backups -Critical services are backed up to `/DockerVol/mealie`. Regular backups can be performed using a script or automation tool. +- Store critical data in a separate, reconstructable volume to ensure data integrity. +- Use `rsync` or similar tool to synchronize the backup with the production volume. ### Restore -Restore the mealie stack by running `./deploy.sh` after backing up the critical services. +```bash +cd services/swarm/stack/mealie +./deploy.sh +``` --- ## Common Failures -| Symptom | Cause | Fix | -|---------|------|-----| -- Service not available | Caddy not configured | Check `caddy.config` file and ensure it's correct. -- Uptime Kuma not monitoring | Insecure protocol used | Ensure that the `kuma.*` labels are set to use a secure protocol. +- **Service not running**: Check the service logs and verify that the Docker stack is deployed correctly. +- **Authentication issues**: Ensure that the Authentik authentication settings are correct. +- **Caddy reverse proxy configuration issues**: Verify that the Caddy labels are applied correctly. --- @@ -102,19 +125,11 @@ Restore the mealie stack by running `./deploy.sh` after backing up the critical | Date | Commit | Summary | |------|--------|---------| -| 2026-04-20 | f397da91 | Initial documentation for mealie stack. | -| 2026-04-20 | 5b7ee307 | Updated environment variables for mealie stack. | -| 2026-04-19 | e9ad12cd | Added support for HTTPS in Caddy configuration. | -| 2026-04-19 | 5975ef4a | Fixed issue with Uptime Kuma monitoring. | -| 2026-04-19 | a9f38a47 | Improved security by enabling secure protocols. | +| 2026-04-20 | c77cd7d4 | Initial documentation and setup. | +| 2026-04-20 | f397da91 | Minor bug fixes and code optimizations. | +| 2026-04-20 | 5b7ee307 | Improved Caddy reverse proxy configuration. | +| 2026-04-19 | e9ad12cd | Authentik authentication settings updated. | - - -This mealie stack was created to provide a recipe manager for the NetGrimoire community. It has undergone several changes and updates, including improvements to Caddy configuration and Uptime Kuma monitoring. - ---- - -## Notes -- Generated by Gremlin on 2026-04-20T19:16:44.610Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file +Generated by Gremlin on 2026-04-20T19:23:57.949Z +Source: swarm/mealie.yaml +Review User Guide and Changelog sections \ No newline at end of file