From 36eee9423b84647f5df0c7f3e20b4ae7c5b6133e Mon Sep 17 00:00:00 2001 From: traveler Date: Thu, 16 Apr 2026 00:19:11 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 62 ++++++++++----------------- 1 file changed, 22 insertions(+), 40 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 72ceebb..d2c8079 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,24 +1,11 @@ ---- - -title: mealie Stack -description: Recipe Manager for NetGrimoire -published: true -date: 2026-04-16T05:12:34.909Z -tags: docker,swarm,mealie,netgrimoire -editor: markdown -dateCreated: 2026-04-16T05:12:34.909Z ---- - # mealie ## Overview -The mealie stack is a Recipe Manager service for NetGrimoire. It provides features such as recipe listing and management. - ---- +The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe manager for users. It exposes the Mealie frontend at `https://recipe.netgrimoire.com` and acts as a reverse proxy, Caddy configuration indicates that it listens on `9000`, which aligns with this. ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|------| +|---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire - **Exposed via:** `recipe.netgrimoire.com` @@ -29,15 +16,12 @@ The mealie stack is a Recipe Manager service for NetGrimoire. It provides featur ## Build & Configuration ### Prerequisites -Ensure that the necessary Docker Swarm and environment variables are set. - -### Volume Setup -```bash +``` mkdir -p /DockerVol/mealie -chown -R 1001:1001 /DockerVol/mealie +chown -R user:group /DockerVol/mealie ``` -### Environment Variables +### Volume Setup ```bash # generate: openssl rand -hex 32 PUID=1001 @@ -75,7 +59,7 @@ docker stack services mealie ``` ### First Run -After the initial deployment, verify that the service is accessible and running. +Set up any necessary dependencies or configurations after deployment. --- @@ -84,40 +68,38 @@ After the initial deployment, verify that the service is accessible and running. ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **Recipe Manager** | `recipe.netgrimoire.com` | Access recipes and management interface +- Caddy reverse proxy: `recipe.netgrimoire.com` (Internal only) ### Primary Use Cases -Use this service to manage recipes in NetGrimoire. +Describe the typical use cases for this service in NetGrimoire. ### NetGrimoire Integrations -This service integrates with authentik for OAuth authentication. +List any other services or integrations that mealie connects to, such as authentication providers or other recipes. --- ## Operations ### Monitoring +[kuma monitors from kuma.* labels] + ```bash docker stack services mealie -docker service logs mealie -f +# docker service logs --follow ``` ### Backups -Critical: `/DockerVol/mealie` and reconstructable +Critical vs reconstructable /DockerVol/ paths for backup and restore operations. ### Restore -```bash -cd services/swarm/stack/mealie -./deploy.sh -``` +Restore the entire stack with `./deploy.sh`. --- ## Common Failures -| Failure Mode | Symptoms | Cause | Fix | -|-------------|----------|------|-----| -- Inaccessible service | Service not responding | Incorrect environment variables or configuration issues | Check and correct environment variables and ensure proper Docker Swarm setup. | -- Unauthorized access | Unable to log in with credentials | Incorrect authentication settings | Review and update the OAuth configuration and client IDs. | +| Symptom | Cause | Fix | +|---------|-------|-----| +| | | | --- @@ -125,14 +107,14 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-16 | b46925df | Initial documentation creation | -| 2026-04-15 | e1f9ff52 | Updated environment variables for mealie stack | +| 2026-04-16 | 6d846761 | Initial documentation and initial deployment of the mealie stack. | +| 2026-04-15 | e1f9ff52 | | --- ## Notes -- Generated by Gremlin on 2026-04-16T05:12:34.909Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file +Generated by Gremlin on 2026-04-16T05:16:24.090Z. +Source: swarm/mealie.yaml +Review User Guide and Changelog sections \ No newline at end of file