diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index df6007c..1da593e 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -2,24 +2,26 @@ title: mealie Stack description: Recipe Manager for NetGrimoire published: true -date: 2026-04-20T18:15:54.217Z +date: 2026-04-20T19:16:44.610Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-20T18:15:54.217Z +dateCreated: 2026-04-20T19:16:44.610Z + --- # mealie ## Overview -The mealie Stack is a Docker Swarm-based Recipe Manager for NetGrimoire, providing a centralized platform for managing and sharing recipes. +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. + +--- ## Architecture - | Service | Image | Port | Role | -|---------|-------|------|------| +|---------|-----|-----|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com +- **Exposed via:** `recipe.netgrimoire.com` - **Homepage group:** PNCHarris Apps --- @@ -27,39 +29,17 @@ The mealie Stack is a Docker Swarm-based Recipe Manager for NetGrimoire, providi ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +This stack requires the mealie-stack.yml file to be generated with the correct environment variables and Docker configurations. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R user:group /DockerVol/mealie +chown -R 1001:1001 /DockerVol/mealie ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 -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 @@ -73,7 +53,7 @@ docker stack services mealie ``` ### First Run -After deploying the mealie Stack, you may need to update the recipe database by running `./deploy.sh`. +After deploying, ensure that the services are healthy and Uptime Kuma is monitoring them. --- @@ -82,41 +62,39 @@ After deploying the mealie Stack, you may need to update the recipe database by ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **recipe:** https://recipe.netgrimoire.com +- Caddy: `recipe.netgrimoire.com` +- Uptime Kuma: `https://kuma.netgrimoire.com` ### Primary Use Cases -To use this service in NetGrimoire, you can create a new recipe and share it with others. The recipe manager provides features for managing and sharing recipes. +This service provides a recipe manager for the NetGrimoire community. Users can access recipes, manage their accounts, and participate in discussions. ### NetGrimoire Integrations -The mealie Stack integrates with other services in NetGrimoire, including Authentik and Uptime Kuma. +This service integrates with other NetGrimoire services, including Authentik and Crowdsec, using environment variables and labels. --- ## Operations ### Monitoring -Monitoring the mealie Stack is handled by Uptime Kuma, which can be accessed at kuma.mealie.netgrimoire.com. - +Uptime Kuma monitors the mealie stack for health and performance issues. Check `docker stack services mealie` for more information. ```bash docker stack services mealie docker service logs -f mealie ``` ### Backups -Backups of critical data are stored in `/DockerVol/mealie`. Regular backups should be performed to ensure data integrity. +Critical services are backed up to `/DockerVol/mealie`. Regular backups can be performed using a script or automation tool. ### Restore -To restore the mealie Stack from a backup, run `./deploy.sh`. +Restore the mealie stack by running `./deploy.sh` after backing up the critical services. --- ## Common Failures - | Symptom | Cause | Fix | |---------|------|-----| -1. Service not responding | Insufficient resources or incorrect configuration | Check resource allocation and update configuration as needed. -2. Recipe database corruption | Incomplete backups or incorrect restore process | Verify backup integrity and use a full restore. -3. Authentik integration issues | Incorrect OIDC settings or Authentik server downtime | Review OIDC settings and ensure proper authentication flow. +- 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. --- @@ -124,15 +102,19 @@ To restore the mealie Stack from a backup, run `./deploy.sh`. | Date | Commit | Summary | |------|--------|---------| -| 2026-04-20 | 5b7ee307 | Initial documentation for mealie Stack | -| 2026-04-19 | e9ad12cd | Updated recipe database schema | -| 2026-04-19 | 5975ef4a | Fixed Authentik integration issues | -| 2026-04-19 | a9f38a47 | Improved logging and monitoring for mealie Stack | -| 2026-04-19 | 93b80043 | Enhanced security features for mealie Stack | -| 2026-04-19 | edd41879 | Updated recipe database with new feature | -| 2026-04-19 | 55fd7e29 | Fixed service not responding issue | -| 2026-04-19 | bef8ba8a | Improved performance and scalability for mealie Stack | +| 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. | - - - \ No newline at end of file + + +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