diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 5e48156..43204e8 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,31 +1,31 @@ --- title: mealie Stack -description: Mealie recipe manager +description: Mealie recipe manager in NetGrimoire published: true -date: 2026-04-24T04:48:34.567Z +date: 2026-04-28T18:19:02.408Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-24T04:48:34.567Z +dateCreated: 2026-04-28T18:19:02.408Z --- # mealie ## Overview -The mealie stack provides a recipe manager service for NetGrimoire. It consists of the mealie service, which is responsible for managing recipes and providing a user-friendly interface. +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. ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|-------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com, Internal only +- **Exposed via:** `recipe.netgrimoire.com` - **Homepage group:** PNCHarris Apps --- + ## Build & Configuration ### Prerequisites -Ensure you have the necessary Docker and Caddy configurations in place. +No specific prerequisites are required for this stack. ### Volume Setup ```bash @@ -71,34 +71,36 @@ docker stack services mealie ``` ### First Run -No specific steps required for a first run. +No specific steps are required for the first run. --- + ## User Guide ### Accessing mealie | Service | URL | Purpose | -|---------|-----|---------| -- recipe.netgrimoire.com +- **Host**: `recipe.netgrimoire.com` +- **Port**: 9000 (Internal only) ### Primary Use Cases -Access the recipe manager service to manage recipes and provide a user-friendly interface. +To access the Mealie recipe manager, navigate to `https://recipe.netgrimoire.com` in your web browser. ### NetGrimoire Integrations -This service connects to authentik for OIDC authentication. +The mealie stack connects to other services through environment variables and labels. Specifically, it integrates with Authentik for OIDC authentication. --- + ## Operations ### Monitoring +[kuma monitors from kuma.* labels] ```bash docker stack services mealie -docker service logs -f mealie + ``` ### Backups -Critical: Regular backups of the recipe data are necessary. The /DockerVol/mealie directory should be backed up regularly. -Reconstructable: The configuration files can be rebuilt from the Docker Stack. +Critical data should be backed up regularly. Reconstructing the data may not always be possible. ### Restore ```bash @@ -107,26 +109,30 @@ cd services/swarm/stack/mealie ``` --- + ## Common Failures -| Symptom | Cause | Fix | -|---------|-------|------| -- Service not accessible | Caddy not running | Restart caddy service | -- Recipe data lost | Regular backups not executed | Execute regular backup routine | -- Config file corrupted | Incorrect config file version | Update config file to latest version | -- OIDC authentication issues | authentik configuration incorrect | Review and update authentik configuration | -- Recipe management errors | Mealie configuration incorrect | Review and update mealie configuration | +| 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. --- + ## Changelog | Date | Commit | Summary | |------|--------|---------| -- 2026-04-23 | c58c7bc2 | Initial documentation creation | -| 2026-04-23 | 8fbdfbec | Update Caddy reverse proxy label | -| 2026-04-23 | 1cc32c85 | Update homepage description | -| 2026-04-23 | f00d649e | Update NetGrimoire integrations section | -| 2026-04-23 | 824ed13e | Update common failures section | +| 2026-04-28 | 70884ef2 | Initial documentation for mealie stack in NetGrimoire | +| 2026-04-27 | 0b974044 | | +| 2026-04-23 | c58c7bc2 | | - - - \ No newline at end of file +--- + +## Notes +- Generated by Gremlin on 2026-04-28T18:19:02.408Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file