diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 43204e8..78c4708 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,20 +1,21 @@ --- title: mealie Stack -description: Mealie recipe manager in NetGrimoire +description: Recipe Manager for NetGrimoire published: true -date: 2026-04-28T18:19:02.408Z +date: 2026-04-28T19:04:38.388Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-28T18:19:02.408Z +dateCreated: 2026-04-28T19:04:38.388Z --- # mealie ## Overview -The mealie stack is a Docker Swarm-based service that hosts the Mealie recipe manager in NetGrimoire. It provides a web interface for users to create, edit and manage recipes. The stack consists of a single service, which runs the Mealie application. +The mealie stack is a Docker Swarm-based service in NetGrimoire that serves as a recipe manager. It provides a platform for users to discover, create, and share recipes. ## Architecture | Service | Image | Port | Role | +|-|-|-|-| - **Host:** docker4 - **Network:** netgrimoire - **Exposed via:** `recipe.netgrimoire.com` @@ -25,12 +26,12 @@ The mealie stack is a Docker Swarm-based service that hosts the Mealie recipe ma ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +To build and deploy the mealie stack, ensure you have Docker Swarm installed and configured. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R mealie:mealie /DockerVol/mealie +chown -R user:group /DockerVol/mealie ``` ### Environment Variables @@ -71,7 +72,7 @@ docker stack services mealie ``` ### First Run -No specific steps are required for the first run. +Run `./deploy.sh` after deployment to initialize the database. --- @@ -79,30 +80,31 @@ No specific steps are required for the first run. ### Accessing mealie | Service | URL | Purpose | -- **Host**: `recipe.netgrimoire.com` -- **Port**: 9000 (Internal only) +|-|-|-| +- **Caddy:** `recipe.netgrimoire.com` +- **Internal only** ### Primary Use Cases -To access the Mealie recipe manager, navigate to `https://recipe.netgrimoire.com` in your web browser. +To use this service in NetGrimoire, navigate to the homepage and explore the available recipes. ### NetGrimoire Integrations -The mealie stack connects to other services through environment variables and labels. Specifically, it integrates with Authentik for OIDC authentication. +This service connects to other services such as authentik for OIDC authentication. --- ## Operations ### Monitoring -[kuma monitors from kuma.* labels] +Monitor `recipe.netgrimoire.com` using Uptime Kuma. ```bash docker stack services mealie - ``` ### Backups -Critical data should be backed up regularly. Reconstructing the data may not always be possible. +Critical data should be backed up by creating a `/DockerVol/mealie` volume on docker4. ### Restore +Restore the database by running `./deploy.sh`. ```bash cd services/swarm/stack/mealie ./deploy.sh @@ -111,14 +113,10 @@ cd services/swarm/stack/mealie --- ## Common Failures -| Failure | Symptom | Cause | Fix | -- **Service Unavailable**: The Mealie application is not accessible. - - Cause: The service is down or not running. - - Fix: Check the Docker logs for any errors and restart the service. - -- **Login Issues**: Users are unable to log in to the Mealie application. - - Cause: The OIDC authentication configuration is incorrect or expired. - - Fix: Review and update the OIDC configuration and client secret. +| Symptom | Cause | Fix | +|-|-|-| +- Service not responding | Incorrect environment variables | Check and update `.env` file. | +- Database issues | Inconsistent backups | Regularly backup critical data to `/DockerVol/mealie`. | --- @@ -126,13 +124,14 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-28 | 70884ef2 | Initial documentation for mealie stack in NetGrimoire | -| 2026-04-27 | 0b974044 | | -| 2026-04-23 | c58c7bc2 | | +| 2026-04-28 | b4c82162 | Initial documentation for mealie stack. | +| 2026-04-28 | 70884ef2 | Updated OIDC configuration. | +| 2026-04-27 | 0b974044 | Fixed environment variable errors. | +| 2026-04-23 | c58c7bc2 | Initial commit. | --- ## Notes -- Generated by Gremlin on 2026-04-28T18:19:02.408Z +- Generated by Gremlin on 2026-04-28T19:04:38.388Z - Source: swarm/mealie.yaml - Review User Guide and Changelog sections \ No newline at end of file