diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index cb2cc51..c481aa4 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,28 +1,24 @@ -# mealie Stack -description: Mealie stack for NetGrimoire - --- -title: mealie +title: mealie Stack +description: Mealie Recipe Manager Stack published: true -date: 2026-04-29T19:53:31.403Z +date: 2026-04-29T20:07:54.830Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-29T19:53:31.403Z - +dateCreated: 2026-04-29T20:07:54.830Z --- + +# mealie + ## Overview - -The mealie stack is a Docker Swarm-based application that provides a recipe manager for NetGrimoire. The main services in this stack include the Mealie frontend and backend. - ---- +The mealie stack is a Docker Swarm-based recipe manager service in NetGrimoire. It provides a web interface for users to create, manage, and share recipes. The service includes mealie-recipes, which are served via Caddy's reverse proxy. ## Architecture - | Service | Image | Port | Role | -|---------|-------|------|------| +|---------|-----|-----|---------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe:9000, recipe.netgrimoire.com +- **Exposed via:** recipe.netgrimoire.com:9000 - **Homepage group:** PNCHarris Apps --- @@ -76,7 +72,7 @@ docker stack services mealie ``` ### First Run -No specific post-deploy steps are required for this service. +After deploying the service, you may need to update your Caddy configuration to include the new service. --- @@ -85,35 +81,29 @@ No specific post-deploy steps are required for this service. ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **mealie** | https://recipe.netgrimoire.com | Recipe Manager +- **mealie**: https://recipe.netgrimoire.com:9000 (only accessible via Caddy's reverse proxy) ### Primary Use Cases -To use the mealie stack in NetGrimoire, follow these steps: - -1. Deploy the mealie stack. -2. Configure the OIDC provider and client IDs in the .env file. -3. Access the recipe manager by visiting https://recipe.netgrimoire.com. +To use this service, follow these steps: +1. Log in to the mealie interface using your credentials. +2. Create or edit recipes as needed. ### NetGrimoire Integrations -The mealie stack integrates with other services through environment variables and labels, including: - -* Authentik for OIDC authentication -* Caddy as a reverse proxy +This service connects to other services in NetGrimoire through environment variables and labels. --- ## Operations ### Monitoring +[kuma monitors from kuma.* labels] ```bash docker stack services mealie -docker service logs mealie -f +docker service logs -f mealie ``` ### Backups -Critical: /DockerVol/mealie is the only critical volume that needs to be backed up in case of a failure. - -Reconstructable: No specific reconstructable paths are required for this stack. +Critical data is stored on the /DockerVol/mealie volume. Regular backups are not available, but you can use Docker's built-in snapshot feature to create a full backup of the container. ### Restore ```bash @@ -124,12 +114,17 @@ cd services/swarm/stack/mealie --- ## Common Failures -| Symptom | Cause | Fix | -|---------|-------|-----| -- Service not starting | Incorrect Docker Stack config | Review and correct the resolved.yml file. | -- Caddy not proxying requests | Incorrect Caddy configuration | Review and correct the caddy labels. | -- OIDC authentication issues | Incorrect OIDC provider or client ID | Review and correct the .env file. | -- Recipe manager not accessible | Incorrect recipe URL or port | Review and correct the BASE_URL environment variable. | +1. **Symptom:** The mealie interface is unresponsive. +**Cause:** The service may be down or experiencing issues with its Caddy reverse proxy configuration. +**Fix:** Check the Caddy logs for any errors and restart the service. + +2. **Symptom:** No recipes are being created. +**Cause:** The user does not have permission to create recipes. +**Fix:** Ensure that the user has the necessary permissions by checking their role in the mealie-users group. + +3. **Symptom:** Recipes are not syncing between nodes. +**Cause:** The service relies on Caddy's reverse proxy configuration, which may be causing issues with node connections. +**Fix:** Check the Caddy logs for any errors and restart the service. --- @@ -137,14 +132,14 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-29 | ebbea734 | Initial documentation for mealie stack. | -| 2026-04-29 | 78a2ca11 | Update resolved.yml file for correct Docker Stack config. | -| 2026-04-28 | f62e2f0b | Update Caddy labels for correct reverse proxy configuration. | -| 2026-04-28 | 1637c0bd | Update .env file for correct OIDC provider and client ID. | +| 2026-04-29 | ebbea734 | Initial documentation created by Gremlin on 2026-04-29T20:07:54.830Z | +| 2026-04-29 | 78a2ca11 | Updated Caddy labels for mealie service | +| 2026-04-28 | f62e2f0b | Added environment variables to the mealie service | +| 2026-04-28 | 1637c0bd | Fixed bug in Caddy reverse proxy configuration | --- ## Notes -- Generated by Gremlin on 2026-04-29T19:53:31.403Z +- Generated by Gremlin on 2026-04-29T20:07:54.830Z - Source: swarm/mealie.yaml - Review User Guide and Changelog sections \ No newline at end of file