diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 5065c78..9758bbb 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,24 +1,25 @@ --- title: mealie Stack -description: Recipe Manager +description: Recipe Manager for NetGrimoire published: true -date: 2026-04-15T20:20:41.994Z +date: 2026-04-15T20:46:39.787Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-15T20:20:41.994Z +dateCreated: 2026-04-15T20:46:39.787Z --- # mealie ## Overview -The mealie stack is a recipe manager service in NetGrimoire, providing a centralized platform for users to manage and share recipes. +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. + +--- ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|-----| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com:9000` +- **Exposed via:** `recipe.netgrimoire.com`, `recipe:9000` - **Homepage group:** PNCHarris Apps --- @@ -26,16 +27,16 @@ The mealie stack is a recipe manager service in NetGrimoire, providing a central ## Build & Configuration ### Prerequisites -- Docker Swarm installed and configured +No specific prerequisites are required for this stack. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R user:user /DockerVol/mealie +chown -R 1001:1001 /DockerVol/mealie ``` ### Environment Variables -```bash +``` PUID=1001 PGID=998 TZ=America/Chicago @@ -71,7 +72,7 @@ docker stack services mealie ``` ### First Run -- Initialize database and perform any necessary setup +No specific post-deploy steps are required for this service. --- @@ -79,18 +80,17 @@ docker stack services mealie ### Accessing mealie | Service | URL | Purpose | -|---------|-----|---------| -- **Caddy:** `recipe.netgrimoire.com` -- **Internal only:** +- **Caddy Reverse Proxy:** `recipe.netgrimoire.com`, `recipe:9000` +- **Kuma Monitoring:** kuma.recipe.http.name=Mealie, kuma.recipe.http.url=https://recipe.netgrimoire.com ### Primary Use Cases -- Manage and share recipes with users -- Integrate with other NetGrimoire services for authentication and authorization +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. ### NetGrimoire Integrations -- authentik -- Uptime Kuma (monitoring) -- Caddy (reverse proxy) +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. --- @@ -103,22 +103,17 @@ docker service logs -f mealie ``` ### Backups -- Critical: `/DockerVol/mealie` -- Reconstructable: `/DockerVol/mealie` +Critical services should be backed up to `/DockerVol/mealie` using `chown -R 1001:1001 /DockerVol/mealie`. ### Restore -```bash -cd services/swarm/stack/mealie -./deploy.sh -``` +To restore the mealie Stack, redeploy it using the provided Docker Swarm configuration. --- ## Common Failures -| Symptom | Cause | Fix | -|---------|------|-----| -- Service not starting | Incorrect environment variables | Review and correct environment variables in .env file | -- Database issues | Database corruption or data loss | Run database repair script and recreate database | +| 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. | --- @@ -126,12 +121,12 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-15 | e7979588 | Initial documentation created | -| 2026-04-14 | f555f48b | Updated environment variables to include new OIDC settings | +| 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. | ---- - -Notes -Generated by Gremlin on 2026-04-15T20:20:41.994Z +