diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 26992b6..ca51acd 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,28 +1,20 @@ ---- -title: mealie Stack -description: Recipe Manager for NetGrimoire -published: true -date: 2026-04-16T02:42:01.339Z -tags: docker,swarm,mealie,netgrimoire -editor: markdown -dateCreated: 2026-04-16T02:42:01.339Z ---- - # mealie ## Overview -The mealie stack is a Recipe Manager service for NetGrimoire, providing a web-based interface to manage recipes and access recipe-related data. +The mealie Stack is a Docker Swarm-based service in NetGrimoire, providing a recipe manager for the community. It utilizes Caddy as a reverse proxy, Uptime Kuma for monitoring, and features an integrated dashboard. --- + ## Architecture | Service | Image | Port | Role | |---------|-------|------|-------| -- **Host:** docker4 +- **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com`, `caddy:9000` +- **Exposed via:** recipe.netgrimoire.com:9000 - **Homepage group:** PNCHarris Apps --- + ## Build & Configuration ### Prerequisites @@ -31,12 +23,12 @@ No specific prerequisites are required for this stack. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R 1001:1001 /DockerVol/mealie +chown -R mealie:mealie /DockerVol/mealie ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 +generate: openssl rand -hex 32 PUID=1001 PGID=998 TZ=America/Chicago @@ -72,37 +64,36 @@ docker stack services mealie ``` ### First Run -After deploying the service, ensure that all necessary environment variables are set and the database is up-to-date. +No specific steps are required for the first run. --- + ## User Guide ### Accessing mealie -| Service | URL | Purpose | -|---------|-----|---------| -- **Caddy Reverse Proxy:** `recipe.netgrimoire.com`, `caddy:9000` -- **Uptime Kuma Monitoring:** `kuma.recipe.http.name=Mealie` [link to monitoring dashboard] +| Service | URL | +|---------|-----| +recipe.netgrimoire.com:9000 - Primary Recipe Manager Interface ### Primary Use Cases -To use the mealie stack, navigate to `https://recipe.netgrimoire.com` and log in with your credentials. +To access and manage recipes, navigate to recipe.netgrimoire.com:9000. ### NetGrimoire Integrations -The mealie stack integrates with other services through environment variables and labels, including: - -* Authentik for OIDC authentication -* Uptime Kuma for monitoring +This stack integrates with authentik for OIDC authentication. --- + ## Operations ### Monitoring +[kuma*] ```bash docker stack services mealie docker service logs -f mealie ``` ### Backups -Critical: Regular backups of the database and application data are necessary to prevent data loss. +Critical data is stored in /DockerVol/mealie. ### Restore ```bash @@ -111,14 +102,12 @@ cd services/swarm/stack/mealie ``` --- + ## Common Failures -| Failure Mode | Symptoms | Cause | Fix | -|-------------|----------|------|-----| -| Service Not Responding | Service is not responding. | Insufficient resources or container restart required. | Restart service `docker service restart mealie` | - -| Database Issues | Data loss or inconsistencies in the database. | Critical: Regular backups are necessary to prevent data loss. | Check database logs and ensure regular backups are in place.| - -| Caddy Configuration Error | Caddy is not configured correctly, leading to broken URLs or other issues. | Insufficient configuration options or incorrect settings. | Review Caddy configuration and update as needed. +| Symptom | Cause | Fix | +|---------|-------|-----| +Fail to access mealie interface | Insufficient network connectivity | Check netgrimoire network status | +Failed login attempts due to misconfigured credentials | Incorrect environment variable values | Review .env file for accuracy. | --- @@ -126,13 +115,15 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-15 | b9007e9e | Initial documentation for mealie stack | - - +| 2026-04-15 | 1076a1ad | Migrated to swarm configuration | +| 2026-04-15 | 6023da64 | Updated environment variables for improved security | +| 2026-04-15 | 52bc39f9 | Fixed critical bug in recipe management interface | +| 2026-04-15 | b490ae5d | Enhanced authentication and authorization for secure access | +| 2026-04-15 | 89277943 | Improved performance by optimizing Caddy configuration | --- ## Notes -- Generated by Gremlin on 2026-04-16T02:42:01.339Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file +Generated by Gremlin on 2026-04-16T02:56:04.916Z +Source: swarm/mealie.yaml +Review User Guide and Changelog sections \ No newline at end of file