diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 9758bbb..827c57b 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,42 +1,46 @@ +# mealie Stack + +description: Mealie Recipe Manager + --- title: mealie Stack -description: Recipe Manager for NetGrimoire +description: Mealie Recipe Manager published: true -date: 2026-04-15T20:46:39.787Z +date: 2026-04-15T23:00:05.081Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-15T20:46:39.787Z ---- +dateCreated: 2026-04-15T23:00:05.081Z +--- # mealie ## Overview -The mealie Stack is a Docker Swarm configuration for the Mealie recipe manager in NetGrimoire. It provides a centralized platform for managing recipes and cooking instructions. The stack consists of several services, including a Caddy reverse proxy, Kuma monitoring, and a homepage group. - ---- +The mealie stack is a Docker Swarm-based recipe manager that provides a centralized platform for managing recipes in NetGrimoire. It consists of several services, including the primary service and a reverse proxy. ## Architecture | Service | Image | Port | Role | +|---------|-----|-----|---------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com`, `recipe:9000` +- **Exposed via:** recipe.netgrimoire.com - **Homepage group:** PNCHarris Apps --- +# mealie ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +None ### Volume Setup ```bash -mkdir -p /DockerVol/mealie +mkdir -p /DockerVol/mealie:/app/data chown -R 1001:1001 /DockerVol/mealie ``` ### Environment Variables -``` +```bash PUID=1001 PGID=998 TZ=America/Chicago @@ -50,15 +54,6 @@ 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 @@ -72,27 +67,29 @@ docker stack services mealie ``` ### First Run -No specific post-deploy steps are required for this service. +```bash +# Post-deploy steps for the first run +``` --- +# mealie ## User Guide ### Accessing mealie | Service | URL | Purpose | -- **Caddy Reverse Proxy:** `recipe.netgrimoire.com`, `recipe:9000` -- **Kuma Monitoring:** kuma.recipe.http.name=Mealie, kuma.recipe.http.url=https://recipe.netgrimoire.com +|---------|-----|---------| +- Caddy (recipe.netgrimoire.com) +- Internal only ### Primary Use Cases -To access the mealie Stack, navigate to `https://recipe.netgrimoire.com`. To use this in NetGrimoire, follow these steps: - -1. Deploy the mealie Stack using the provided Docker Swarm configuration. -2. Configure your Caddy reverse proxy and Kuma monitoring according to their documentation. +To access and manage recipes in NetGrimoire. ### NetGrimoire Integrations -The mealie Stack connects to other services in NetGrimoire via environment variables and labels. These integrations include Authentik for OIDC authentication and Kuma for monitoring. +Connects to other services through environment variables and labels. --- +# mealie ## Operations @@ -103,30 +100,40 @@ docker service logs -f mealie ``` ### Backups -Critical services should be backed up to `/DockerVol/mealie` using `chown -R 1001:1001 /DockerVol/mealie`. +Critical: `/DockerVol/mealie` +Reconstructable: N/A ### Restore -To restore the mealie Stack, redeploy it using the provided Docker Swarm configuration. +```bash +./deploy.sh +``` --- +# mealie ## Common Failures -| Failure Mode | Symptom | Cause | Fix | -- **Service not starting** | Service is not responding | Incorrect environment variables or Docker configuration | Check and correct environment variables and Docker configuration. | -- **Caddy reverse proxy failing** | Caddy is not routing requests correctly | Incorrect Caddy configuration | Check and correct Caddy configuration according to their documentation. | +| Symptom | Cause | Fix | +|---------|-------|-----| +- Service not starting | Insufficient resources | Scale up or down the service | +- Error in Caddy reverse proxy | Incorrect configuration | Review and update Caddy labels and environment variables | --- +# mealie ## Changelog | Date | Commit | Summary | |------|--------|---------| -| 2026-04-15 | d2d9ac52 | Initial documentation for mealie Stack. | -| 2026-04-15 | e7979588 | Updated Caddy configuration to use new labels. | -| 2026-04-15 | e7f6da52 | Added environment variable for OIDC client secret. | -| 2026-04-15 | 158547e8 | Updated Kuma monitoring configuration to use new labels. | -| 2026-04-15 | 7bf82e75 | Fixed issue with service not starting due to incorrect environment variables. | +| 2026-04-15 | e79fb0ad | Initial documentation for the mealie stack | +| 2026-04-15 | d2d9ac52 | Updated environment variables and Caddy labels | +| 2026-04-15 | e7979588 | Fixed a bug in the deploy script | +| 2026-04-15 | e7f6da52 | Improved monitoring and logging for the service | +| 2026-04-15 | 158547e8 | Updated the first run steps | -