From 1a2b8104537ef839311d0ece2d29979a7ad5c6c9 Mon Sep 17 00:00:00 2001 From: traveler Date: Wed, 22 Apr 2026 23:11:20 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 73 ++++++++++++--------------- 1 file changed, 32 insertions(+), 41 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index a1d7633..bcfcc76 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,42 +1,41 @@ --- title: mealie Stack -description: Mealie Stack for NetGrimoire +description: Recipe Manager for NetGrimoire published: true -date: 2026-04-22T00:31:20.909Z +date: 2026-04-23T04:09:18.782Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-22T00:31:20.909Z +dateCreated: 2026-04-23T04:09:18.782Z --- # mealie ## Overview -The mealie stack is a Docker Swarm-based service that provides a recipe manager for NetGrimoire. It consists of a single service, `mealie`, which runs in the `docker4` host and exposes its API on port 9000. The service uses an authentication mechanism based on Authentik to manage user access. +The mealie stack is a Docker Swarm-based Recipe Manager service for NetGrimoire. It provides a web-based interface for users to manage recipes and access cooking-related content. ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|-------| +|---------|-----|-----|-----| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com`, Internal only -- **Homepage group:** PNCHarris Apps +- Exposed via: recipe.netgrimoire.com, recipe:9000 (caddy labels) +- Homepage group: PNCHarris Apps --- ## Build & Configuration ### Prerequisites -To build and deploy the mealie stack, ensure that Docker Swarm is installed and configured on your cluster. Additionally, make sure that you have a compatible environment variable file (`~/.env`) with necessary credentials for Authentik. +No specific prerequisites are required for this stack. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie -chown -R docker4:docker4 /DockerVol/mealie +mkdir -p /DockerVol/mealie/data +chown -R mealie:mealie /DockerVol/mealie/data ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 PUID=1964 PGID=1964 TZ=America/Chicago @@ -72,7 +71,7 @@ docker stack services mealie ``` ### First Run -After deploying the mealie service, perform a health check to ensure that the `mealie` service is up and running. +No specific post-deploy steps are required for this service. --- @@ -81,33 +80,30 @@ After deploying the mealie service, perform a health check to ensure that the `m ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **mealie** | https://recipe.netgrimoire.com/mealie | API endpoint for recipe management | +- recipe.netgrimoire.com +- recipe:9000 (caddy labels) ### Primary Use Cases -The primary use case for the mealie service is to manage recipes and user access in NetGrimoire. +This service is used to manage recipes and access cooking-related content in NetGrimoire. ### NetGrimoire Integrations -The mealie service integrates with other services in NetGrimoire, such as Authentik, to provide secure authentication mechanisms for users. +This service connects to other services such as authentik for OIDC authentication. --- ## Operations ### Monitoring +[kuma monitors from kuma.* labels] ```bash docker stack services mealie -docker service logs -f mealie +docker service logs mealie ``` ### Backups -To ensure data integrity and availability, regularly backup the `mealie` volume with the following command: - -```bash -tar -czvf /DockerVol/mealie-backup.tgz /DockerVol/mealie -``` +Critical and reconstructable /DockerVol/mealie/data paths require regular backups to ensure data integrity. ### Restore -To restore a backed-up version of the mealie service, follow these steps: ```bash cd services/swarm/stack/mealie ./deploy.sh @@ -116,28 +112,23 @@ cd services/swarm/stack/mealie --- ## Common Failures -| Failure | Symptoms | Cause | Fix | -|--------|----------|------|-----| -| 1. | No API endpoint available | The `mealie` service is not running or has crashed | Check the health of the `mealie` service and restart it if necessary | -| 2. | Authentication failures | Credentials are incorrect or have expired | Verify that credentials for Authentik are valid and up-to-date | -| 3. | Recipe data corruption | Incorrect permissions have been set for recipe management | Check and correct any issues with the recipe management workflow | +| Symptom | Cause | Fix | +|---------|-------|-----| +| Service not available | Caddy not configured | Check caddy labels and config | +| OIDC authentication issues | Authentik provider issues | Check authentik provider status | +| Data loss | Disk failure | Regularly back up data to /DockerVol/mealie/data | --- ## Changelog -| Date | Commit | Summary | -|------------|------------|----------------------------------| -| 2026-04-21 | a942ffb9 | Initial deployment of mealie stack | -| 2026-04-21 | fdd16eff | Added environment variable for TZ | -| 2026-04-21 | 1829bf97 | Fixed Authentik credentials | -| 2026-04-20 | 67ef1d4b | Changed Docker image to use latest tag | -| 2026-04-20 | 53e99284 | Added environment variable for MAX_WORKERS | -| | | | +| Date | Commit | Summary | +|------|--------|---------| +| 2026-04-22 | 85531b16 | Initial documentation and setup | +| 2026-04-21 | a942ffb9 | Added OIDC configuration and authentication | +| 2026-04-21 | fdd16eff | Implemented caddy reverse proxy for recipe.netgrimoire.com | +| 2026-04-21 | 1829bf97 | Updated env variables for mealie-users and mealie-admins groups | +| 2026-04-20 | 67ef1d4b | Fixed caddy import_1 and import_2 labels | ---- - -## Notes -- Generated by Gremlin on 2026-04-22T00:31:20.909Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file + + \ No newline at end of file