From f7247bdf3e88ea349c00012626737394c5a84d69 Mon Sep 17 00:00:00 2001 From: traveler Date: Wed, 29 Apr 2026 14:55:22 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 52 +++++++++++++-------------- 1 file changed, 24 insertions(+), 28 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 7f31c3b..72c1fb3 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,27 +1,24 @@ --- title: mealie Stack -description: Mealie recipe management platform in NetGrimoire +description: Recipe Manager published: true -date: 2026-04-28T20:04:22.946Z +date: 2026-04-29T19:53:28.323Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-28T20:04:22.946Z - +dateCreated: 2026-04-29T19:53:28.323Z --- # mealie ## Overview -The mealie Stack provides a recipe management platform in NetGrimoire, enabling users to manage and share recipes across the community. It is composed of a single service that runs on docker4, utilizing the netgrimoire overlay network. - ---- +The mealie stack is a Docker Swarm-based application that serves as the recipe manager in NetGrimoire. It provides a web interface for managing recipes and allows users to access them through the netgrimoire overlay network. ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|-----| +|---------|-----|-----|---------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com +- **Exposed via:** recipe:9000 - **Homepage group:** PNCHarris Apps --- @@ -29,12 +26,12 @@ The mealie Stack provides a recipe management platform in NetGrimoire, enabling ## Build & Configuration ### Prerequisites -Ensure Docker and Caddy are installed on the cluster. +No specific prerequisites are required for this stack. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R docker4:docker4 /DockerVol/mealie +chown -R 1964:1964 /DockerVol/mealie ``` ### Environment Variables @@ -75,7 +72,7 @@ docker stack services mealie ``` ### First Run -After initial deployment, the service should be accessible at recipe.netgrimoire.com. Users can log in with their credentials and start managing recipes. +Run the `./deploy.sh` script after initial deployment. --- @@ -84,30 +81,29 @@ After initial deployment, the service should be accessible at recipe.netgrimoire ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **mealie** | https://recipe.netgrimoire.com | Recipe Management Platform | +- **recipe:** https://recipe.netgrimoire.com ### Primary Use Cases -To use this service, users should be familiar with recipe management platforms. They can create and share recipes, manage their own profiles, and engage with the community. +Use the recipe manager to manage recipes in NetGrimoire. ### NetGrimoire Integrations -This service integrates with other services in NetGrimoire, such as authentik for user authentication and monitoring tools like Uptime Kuma to ensure platform availability. +The mealie stack integrates with other services, such as authentik, through OIDC authentication. --- ## Operations ### Monitoring -- `kuma.*`: Ensure Uptime Kuma is installed on the cluster. +[kuma monitors from kuma.* labels] ```bash docker stack services mealie docker service logs -f mealie ``` ### Backups -Critical data stored in /DockerVol/mealie. Regular backups are essential to ensure business continuity. +Critical: `/DockerVol/mealie` is critical for data integrity. Reconstructable: no explicit backup instructions are provided. ### Restore -To restore the service, re-run the deploy script. ```bash cd services/swarm/stack/mealie ./deploy.sh @@ -116,11 +112,10 @@ cd services/swarm/stack/mealie --- ## Common Failures -| Failure Mode | Symptoms | Cause | Fix | -|-------------|----------|------|-----| -| 1. Service Not Accessible | Error message when accessing recipe.netgrimoire.com | Caddy configuration issue or Docker service not running | Check caddy logs and ensure the Docker service is up and running | -| 2. User Authentication Issues | Unable to log in with credentials | OIDC configuration issue or Authentik integration problem | Review OIDC configuration and verify Authentik connection | -| 3. Service Not Deploying | Error message during deploy process | Docker swarm configuration issue or service not found | Check docker stack config file for errors and ensure the service exists in the swarm | +| Symptom | Cause | Fix | +|---------|-------|-----| +- Service not responding | Insufficient resources | Scale service to increase resources | +- Authentication issues | OIDC configuration issues | Check OIDC client ID and secret, ensure correct configuration | --- @@ -128,14 +123,15 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-28 | f62e2f0b | Initial deployment of mealie Stack in NetGrimoire | -| 2026-04-28 | 1637c0bd | Fixed issue with recipe.netgrimoire.com accessibility | - - +| 2026-04-29 | 78a2ca11 | Initial documentation and setup | +| 2026-04-28 | f62e2f0b | | +| 2026-04-28 | 1637c0bd | | +| 2026-04-28 | f7186f36 | | +| 2026-04-28 | afa15f18 | | --- ## Notes -- Generated by Gremlin on 2026-04-28T20:04:22.946Z +- Generated by Gremlin on 2026-04-29T19:53:28.323Z - Source: swarm/mealie.yaml - Review User Guide and Changelog sections \ No newline at end of file