From ce338c52fb862e04caca38a252a109dc645d2da5 Mon Sep 17 00:00:00 2001 From: traveler Date: Thu, 23 Apr 2026 06:38:05 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 56 +++++++++++++-------------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 392e722..91af70a 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,25 +1,26 @@ --- title: mealie Stack -description: Mealie recipe manager in NetGrimoire. +description: Recipe Manager published: true -date: 2026-04-23T04:09:20.245Z +date: 2026-04-23T11:36:00.635Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-23T04:09:20.245Z +dateCreated: 2026-04-23T11:36:00.635Z --- # mealie ## Overview -The mealie stack is a Docker Swarm configuration for the Mealie recipe manager in NetGrimoire. It provides a secure and scalable platform for managing recipes. +The mealie stack is a Recipe Manager service in NetGrimoire. It provides features such as recipe management and authentication. --- ## Architecture | Service | Image | Port | Role | +|---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com, 9927:9000 +- **Exposed via:** `recipe.netgrimoire.com` - **Homepage group:** PNCHarris Apps --- @@ -27,7 +28,7 @@ The mealie stack is a Docker Swarm configuration for the Mealie recipe manager i ## Build & Configuration ### Prerequisites -None specified. +No specific prerequisites are required for this stack. ### Volume Setup ```bash @@ -73,7 +74,7 @@ docker stack services mealie ``` ### First Run -Run `./deploy.sh` to initialize the service. +After deployment, you need to update the kuma configuration and redeploy. --- @@ -81,40 +82,41 @@ Run `./deploy.sh` to initialize the service. ### Accessing mealie | Service | URL | Purpose | -- **Host:** recipe.netgrimoire.com, 9927:9000 -- **Login**: no password login available. -- **Signup**: no signup feature available. +- **Host:** `recipe.netgrimoire.com` +- **Port:** 9000 ### Primary Use Cases -The primary use case is to manage recipes and access the web interface at recipe.netgrimoire.com. +To use this service in NetGrimoire, navigate to the Recipe Manager page on your dashboard and create a new recipe or manage existing ones. ### NetGrimoire Integrations -This service integrates with Authentik for OIDC authentication. +This service connects to other services via OIDC authentication with authentik. --- ## Operations ### Monitoring -[kuma.name: Mealie, kuma.url: https://recipe.netgrimoire.com] ```bash docker stack services mealie -docker service logs -f mealie + ``` ### Backups -Critical services are stored in /DockerVol/mealie and must be backed up regularly. +Critical backups are not available. Restores may be required if data is lost due to an error or intentional deletion. ### Restore -Run `./deploy.sh` to restore the service from a backup. +```bash +cd services/swarm/stack/mealie +./deploy.sh +``` --- ## Common Failures -- **Service not available**: Check the status of the stack: `docker stack services mealie`. -- **Login issues**: Clear cache in browser or try another browser. -- **Signing up fails**: Contact support or check the OIDC configuration URL for errors. -- **Authentik integration issues**: Check Authentik logs and OIDC configuration for errors. +| Symptom | Cause | Fix | +- **Failed deployment** | Insufficient disk space on docker4. | Check and increase available storage. | +- **Login issues** | Incorrect credentials or authentication configuration error. | Verify that the OIDC configuration is correct and redeploy if necessary. | +- **Recipe not saved** | Data write failure due to permissions issue. | Check the file system permissions for the Docker volume and ensure they are set correctly. | --- @@ -122,12 +124,10 @@ Run `./deploy.sh` to restore the service from a backup. | Date | Commit | Summary | |------|--------|---------| -| 2026-04-22 | ce657f97 | Initial documentation creation. | -| 2026-04-22 | 85531b16 | Minor formatting changes. | -| 2026-04-21 | a942ffb9 | Bug fix: fixed typo in environment variable. | -| 2026-04-21 | fdd16eff | Documentation update: added section on primary use cases. | -| 2026-04-21 | 1829bf97 | Minor formatting changes. | +| 2026-04-23 | 9d75346d | Initial documentation | +| 2026-04-22 | ce657f97 | | +| 2026-04-22 | 85531b16 | | +| 2026-04-21 | a942ffb9 | | +| 2026-04-21 | fdd16eff | | -Generated by Gremlin on 2026-04-23T04:09:20.245Z -Source: swarm/mealie.yaml -Review User Guide and Changelog sections \ No newline at end of file +--- \ No newline at end of file