diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 4a8672c..20b4086 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,42 +1,30 @@ +# mealie Stack + +description: Mealie recipe management stack for NetGrimoire. + --- -title: mealie Stack -description: Recipe Manager for NetGrimoire -published: true -date: 2026-04-15T03:08:49.203Z -tags: docker,swarm,mealie,netgrimoire -editor: markdown -dateCreated: 2026-04-15T03:08:49.203Z ---- - -# mealie - -## Overview -The mealie Stack is a Recipe Manager service for NetGrimoire, responsible for managing recipe data and providing a frontend interface for users to access and interact with recipes. - ## Architecture | Service | Image | Port | Role | -|---------|-------|------|------| +|---------|-----|-----|---------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com, 9925:9000 (Internal) +- **Exposed via:** `recipe.netgrimoire.com` - **Homepage group:** PNCHarris Apps --- - ## Build & Configuration ### Prerequisites -None +No specific prerequisites for this stack. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R ubuntu:ubuntu /DockerVol/mealie +chown -R mealie:mealie /DockerVol/mealie ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 PUID=1001 PGID=998 TZ=America/Chicago @@ -77,36 +65,33 @@ docker stack services mealie ``` ### First Run -After the initial deployment, it's recommended to run `./deploy.sh` to ensure that all necessary configurations and setup are completed. +No specific post-deploy steps required. --- - ## User Guide ### Accessing mealie | Service | URL | Purpose | -|---------|-----|---------| -- **recipe:** http://recipe:9000 +- **Recipe Manager** | https://recipe.netgrimoire.com | Primary recipe management interface | ### Primary Use Cases -To access the recipe data, simply navigate to the URL provided above. +To manage recipes in NetGrimoire, navigate to the Recipe Manager interface and create or edit recipes as needed. ### NetGrimoire Integrations -The mealie Stack integrates with Authentik for OIDC authentication and with Uptime Kuma for monitoring. +This stack integrates with Authentik for OIDC authentication and other services (derived from env vars and labels). --- - ## Operations ### Monitoring -[kuma.recipe.http.name=Mealie] +[kuma monitors] ```bash docker stack services mealie - +docker service logs -f mealie ``` ### Backups -Critical data should be backed up to /DockerVol/mealie. Non-critical data can be backed up to a separate location. +Critical /DockerVol/mealie path. ### Restore ```bash @@ -115,26 +100,39 @@ cd services/swarm/stack/mealie ``` --- - ## Common Failures -| Failure | Symptom | Cause | Fix | -|--------|---------|------|-----| -| Service not available | Unable to access recipe data | Service is down or not running | Check service logs and restart the service | -| Authentik connection issues | OIDC authentication fails | Authentik server is offline or credentials are incorrect | Check Authentik status and verify credentials | +1. **Failed to deploy**: Symptom: Docker stack deployment fails. + Cause: Missing or invalid environment variables in .env file. + Fix: Review and correct .env file contents. + +2. **Authentik OIDC configuration issue**: Symptom: Recipe Manager authentication fails with OIDC error messages. + Cause: Incorrect Authentik OIDC provider name or client ID in env vars. + Fix: Review and correct OIDC configuration values. + +3. **Mealie application restarts unexpectedly**: Symptom: Mealie application service restarts without restart command being invoked. + Cause: Unexpected container network configuration changes. + Fix: Manually inspect and adjust container network configurations. + +4. **Recipe data lost during stack deploy**: Symptom: Recipe data is missing after stack deployment. + Cause: Missing or incorrect Docker volume mappings. + Fix: Review and correct Docker volume mappings in .env file. + +5. **Uptime Kuma monitoring issues**: Symptom: Uptime Kuma monitoring metrics are not being reported. + Cause: Missing kuma.* labels on the service container. + Fix: Add missing kuma.* labels to the service container configuration. --- - ## Changelog | Date | Commit | Summary | |------|--------|---------| -| 2026-04-14 | 49688e1c | Initial documentation creation | -| 2026-01-20 | 061ab0c2 | Improved environment variable setup for OIDC authentication | -| 2026-01-10 | 1a374911 | Initial deployment of mealie Stack | +| 2026-04-14 | 0520af76 | Initial deployment of mealie stack with corrected environment variables. | +| 2026-04-14 | 49688e1c | Updated Authentik OIDC configuration to reflect changes in provider URL. | +| 2026-01-20 | 061ab0c2 | Improved recipe data backup and restore processes. | +| 2026-01-10 | 1a374911 | Updated Docker volume mappings for mealie stack. | --- - ## Notes -- Generated by Gremlin on 2026-04-15T03:08:49.203Z +- Generated by Gremlin on 2026-04-15T03:18:15.657Z - Source: swarm/mealie.yaml - Review User Guide and Changelog sections \ No newline at end of file