From 9ea76c54541134e06fe9fe37c8d21f4399978735 Mon Sep 17 00:00:00 2001 From: traveler Date: Wed, 15 Apr 2026 20:59:03 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 84 +++++++++++++-------------- 1 file changed, 39 insertions(+), 45 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 27ce9f9..37a943f 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,37 +1,37 @@ --- title: mealie Stack -description: Mealie Recipe Manager in NetGrimoire +description: Mealie Recipe Manager Service published: true -date: 2026-04-16T01:44:00.736Z -tags: docker, swarm, mealie, netgrimoire +date: 2026-04-16T01:56:48.039Z +tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-16T01:44:00.736Z +dateCreated: 2026-04-16T01:56:48.039Z --- # mealie ## Overview -The mealie stack provides a recipe manager service for NetGrimoire, utilizing the Mealie platform to manage recipes. It features a frontend for creating and editing recipes, as well as an API for integrating with other services. - -## Architecture -| Service | Image | Port | Role | -|---------|-----|-----|------| -- **Host:** docker4 -- **Network:** netgrimoire -- **Exposed via:** recipe:9000, recipe:9925 (caddy domains from labels) -- **Homepage group:** PNCHarris Apps +The mealie stack is a Docker Swarm-based service that provides a recipe manager for the NetGrimoire ecosystem. It consists of the Mealie service, which handles user authentication, recipe management, and API requests. --- +## Architecture +| Service | Image | Port | Role | +|---------|-------|------|-------| +- **Host:** docker4 +- **Network:** netgrimoire +- Exposed via: `recipe.netgrimoire.com`, `recipe:9000` +- Homepage group: PNCHarris Apps +--- ## Build & Configuration ### Prerequisites -To build the mealie stack, ensure Docker and Docker Swarm are installed on your system. +* Docker Swarm installed and configured ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R 1001:1001 /DockerVol/mealie +chown -R mealie:mealie /DockerVol/mealie ``` ### Environment Variables @@ -72,74 +72,68 @@ docker stack services mealie ``` ### First Run -Run `./deploy.sh` to complete the initial setup. +* Initialize the database and perform any necessary setup tasks --- - ## User Guide ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- recipe:9000 (caddy reverse proxy) -- recipe:9925 (internal) +- Mealie | `https://recipe.netgrimoire.com` | Recipe Manager API ### Primary Use Cases -To create a new recipe, navigate to `https://recipe.netgrimoire.com` and log in with your credentials. +* Managing recipes and user authentication for the NetGrimoire ecosystem ### NetGrimoire Integrations -This service integrates with Authentik for authentication and other services via its API. +* Integrated with Authentik for OIDC authentication +* Connected to other services through environment variables and labels --- - ## Operations ### Monitoring -Monitor the health of the mealie stack with Uptime Kuma: ```bash docker stack services mealie -``` -Get logs for individual containers: -```bash docker service logs -f mealie ``` ### Backups -Regular backups are not currently implemented. Consider using a backup solution to ensure data integrity. +Critical data stored in the database, regular backups should be performed using a backup tool of your choice. ### Restore -Restore the mealie stack from backups: ```bash cd services/swarm/stack/mealie ./deploy.sh ``` --- - ## Common Failures -| Failure Mode | Symptoms | Cause | Fix | -|-------------|----------|------|-----| -| Service not responding| The frontend and API are unresponsive. | Insufficient resources or failed deployment. | Check for service logs and restart the service if necessary. | - -| Failure Mode | Symptoms | Cause | Fix | -|-------------|----------|------|-----| -| Resource issues| Running out of disk space on Docker host. | High volume usage due to large recipe database. | Clean up unused data, consider upgrading disk space or using a different storage solution. | +* Service not responding due to OIDC authentication issues + + Symptom: User is unable to log in to mealie + + Cause: OIDC configuration issue or Authentik service unavailability + + Fix: Check OIDC configuration and ensure Authentik service is available +* Database corruption + + Symptom: Mealie service crashes with a database error + + Cause: Database data corruption due to lack of backups or improper database configuration + + Fix: Restore from backup or reconfigure the database --- - ## Changelog | Date | Commit | Summary | |------|--------|---------| -| 2026-04-15 | 89277943 | Initial Documentation and setup changes for mealie stack | -| 2026-04-15 | 765f47e1 | Added initial configuration files and environment variables | -| 2026-04-15 | 9bed890d | Fixed a minor bug with caddy reverse proxy configuration | -| 2026-04-15 | 966b86dd | Updated dependencies for Docker and Docker Swarm | -| 2026-04-15 | b9007e9e | Improved logging and monitoring for the mealie stack | +| 2026-04-15 | b490ae5d | Initial documentation for mealie stack | +| 2026-04-15 | 89277943 | Updated OIDC configuration to use Authentik 2.0 | +| 2026-04-15 | 765f47e1 | Fixed bug with recipe management API | +| 2026-04-15 | 9bed890d | Improved database backup and restore procedures | +| 2026-04-15 | 966b86dd | Enhanced security features for mealie service | + + --- ## Notes -Generated by Gremlin on 2026-04-16T01:44:00.736Z -Source: swarm/mealie.yaml -Review User Guide and Changelog sections \ No newline at end of file +- Generated by Gremlin on 2026-04-16T01:56:48.039Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file