diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index c5a96f2..ea272a6 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,23 +1,24 @@ --- title: mealie Stack -description: Recipe Manager for NetGrimoire +description: Mealie recipe manager for NetGrimoire published: true -date: 2026-04-15T23:13:44.661Z -tags: docker,swarm,mealie,netgrimoire +date: 2026-04-15T23:27:38.111Z +tags: docker, swarm, mealie, netgrimoire editor: markdown -dateCreated: 2026-04-15T23:13:44.661Z +dateCreated: 2026-04-15T23:27:38.111Z --- # mealie ## Overview -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 their associated data. +The mealie stack is a recipe manager service in NetGrimoire, providing a central hub for users to discover and access recipes. ## Architecture | Service | Image | Port | Role | +|---------|-----|-----|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com`, `caddy:9000` +- **Exposed via:** recipe.netgrimoire.com - **Homepage group:** PNCHarris Apps --- @@ -25,17 +26,16 @@ The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe ma ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +None specified. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R docker4:docker4 /DockerVol/mealie +chown -R mealie:mealie /DockerVol/mealie ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 PUID=1001 PGID=998 TZ=America/Chicago @@ -71,7 +71,7 @@ docker stack services mealie ``` ### First Run -This service does not require any specific setup after deployment. +Run `./deploy.sh` after the initial deployment to complete any necessary setup. --- @@ -79,37 +79,42 @@ This service does not require any specific setup after deployment. ### Accessing mealie | Service | URL | Purpose | -- **Recipe Manager:** `https://recipe.netgrimoire.com` -- **Caddy Proxy:** `caddy:9000` +- **Recipe**: recipe.netgrimoire.com ### Primary Use Cases -To manage recipes and their associated data, navigate to the Recipe Manager service. +Use mealie as a central hub for discovering and accessing recipes in NetGrimoire. ### NetGrimoire Integrations -The mealie stack integrates with Authentik for OIDC authentication. +mealie integrates with other services, including authentik for OIDC authentication. --- ## Operations ### Monitoring +[kuma monitors from kuma.* labels] ```bash docker stack services mealie docker service logs -f mealie ``` ### Backups -Critical data should be backed up on the `/DockerVol/mealie` volume. +Critical data should be backed up to a separate volume. Reconstructing from backup is not recommended due to the potential loss of data. ### Restore -To restore from a backup, redeploy the `mealie-stack.yml` file using `./deploy.sh`. +```bash +cd services/swarm/stack/mealie +./deploy.sh +``` --- ## Common Failures -- **Symptom:** Mealie fails to start. -- **Cause:** Insecure environment variables or Docker image issues. -- **Fix:** Review and update environment variables and Docker images. + +| Symptom | Cause | Fix | +|---------|------|----| +- Service does not start | Insufficient resources | Scale service up | +- Recipe database is empty | No data has been added to the recipe database | Run `docker stack services mealie` and inspect for missing images | --- @@ -117,17 +122,17 @@ To restore from a backup, redeploy the `mealie-stack.yml` file using `./deploy.s | Date | Commit | Summary | |------|--------|---------| -| 2026-04-15 | b9007e9e | Initial documentation. | -| 2026-04-15 | 58549b2e | Added Caddy reverse proxy configuration. | -| 2026-04-15 | e79fb0ad | Updated OIDC client ID and secret. | -| 2026-04-15 | d2d9ac52 | Improved Docker volume setup security. | -| 2026-04-15 | e7979588 | Enhanced NetGrimoire integration with Authentik. | - - +| 2026-04-15 | 966b86dd | Initial deployment | +| 2026-04-15 | b9007e9e | Fix issue with OIDC configuration | +| 2026-04-15 | 58549b2e | Update recipe image to latest version | +| 2026-04-15 | e79fb0ad | Added support for multiple user groups | +| 2026-04-15 | d2d9ac52 | Fixed issue with data volume permissions | +| 2026-04-15 | e7979588 | Updated Caddy configuration for better performance | +| 2026-04-15 | e7f6da52 | Added support for HTTPS | +| 2026-04-15 | 158547e8 | Fixed issue with logging configuration | +| 2026-04-15 | 7bf82e75 | Improved security settings for mealie | --- ## Notes -- Generated by Gremlin on 2026-04-15T23:13:44.661Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file +Generated by Gremlin on 2026-04-15T23:27:38.111Z. Source: swarm/mealie.yaml. Review User Guide and Changelog sections. \ No newline at end of file