From ef47086394e1d1b34feea60e73d82bb1cc74fb49 Mon Sep 17 00:00:00 2001 From: traveler Date: Mon, 20 Apr 2026 13:17:38 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 71 +++++++++++++++------------ 1 file changed, 39 insertions(+), 32 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index d42c2a7..df6007c 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,26 +1,26 @@ --- title: mealie Stack -description: Recipe Manager +description: Recipe Manager for NetGrimoire published: true -date: 2026-04-20T02:12:01.924Z +date: 2026-04-20T18:15:54.217Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-20T02:12:01.924Z +dateCreated: 2026-04-20T18:15:54.217Z --- # mealie ## Overview -The mealie stack is a recipe manager service in NetGrimoire, responsible for providing a platform for users to manage and share recipes. - ---- +The mealie Stack is a Docker Swarm-based Recipe Manager for NetGrimoire, providing a centralized platform for managing and sharing recipes. ## Architecture + | Service | Image | Port | Role | -|- **Host:** docker4 | -- **Network:** netgrimoire | -- **Exposed via:** caddy.netgrimoire.com, recipe:9000 | -- **Homepage group:** PNCHarris Apps | +|---------|-------|------|------| +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** recipe.netgrimoire.com +- **Homepage group:** PNCHarris Apps --- @@ -32,7 +32,7 @@ No specific prerequisites are required for this stack. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R 1964:1964 /DockerVol/mealie +chown -R user:group /DockerVol/mealie ``` ### Environment Variables @@ -47,7 +47,7 @@ BASE_URL=https://recipe.netgrimoire.com ALLOW_PASSWORD_LOGIN=false ALLOW_SIGNUP=false OIDC_AUTH_ENABLED=true -OIDC_PROVIDER_NAME=authentik +OIDC_PROVIDER_NAME/authentik OIDC_CONFIGURATION_URL=https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration OIDC_CLIENT_ID=tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz OIDC_CLIENT_SECRET=OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK @@ -73,7 +73,7 @@ docker stack services mealie ``` ### First Run -After deploying, configure the OIDC provider and client IDs in the `.env` file. +After deploying the mealie Stack, you may need to update the recipe database by running `./deploy.sh`. --- @@ -81,51 +81,58 @@ After deploying, configure the OIDC provider and client IDs in the `.env` file. ### Accessing mealie | Service | URL | Purpose | -|- **recipe**: https://recipe.netgrimoire.com | +|---------|-----|---------| +- **recipe:** https://recipe.netgrimoire.com ### Primary Use Cases -To access recipes, navigate to the recipe index page. To create or edit a recipe, click on the "Create Recipe" button. +To use this service in NetGrimoire, you can create a new recipe and share it with others. The recipe manager provides features for managing and sharing recipes. ### NetGrimoire Integrations -This service connects to authentik for OIDC authentication and other services through environment variables. +The mealie Stack integrates with other services in NetGrimoire, including Authentik and Uptime Kuma. --- ## Operations ### Monitoring +Monitoring the mealie Stack is handled by Uptime Kuma, which can be accessed at kuma.mealie.netgrimoire.com. + ```bash docker stack services mealie docker service logs -f mealie ``` ### Backups -Critical data is stored in `/DockerVol/mealie`. This path should be backed up regularly to prevent data loss. +Backups of critical data are stored in `/DockerVol/mealie`. Regular backups should be performed to ensure data integrity. ### Restore -To restore the container, run `./deploy.sh` and follow the prompts. +To restore the mealie Stack from a backup, run `./deploy.sh`. --- ## Common Failures -| Failure Mode | Symptom | Cause | Fix | -|- **Network issue**: Cannot connect to recipe server. | Connection timed out. | Insufficient network bandwidth or misconfigured Docker Swarm. | Check network configuration and adjust as necessary. | -|- **Authentication failed**: Unable to authenticate with OIDC provider. | Authentication failed after retrying multiple times. | Incorrect OIDC client IDs or configuration. | Verify OIDC configuration in .env file and adjust as necessary. | + +| Symptom | Cause | Fix | +|---------|------|-----| +1. Service not responding | Insufficient resources or incorrect configuration | Check resource allocation and update configuration as needed. +2. Recipe database corruption | Incomplete backups or incorrect restore process | Verify backup integrity and use a full restore. +3. Authentik integration issues | Incorrect OIDC settings or Authentik server downtime | Review OIDC settings and ensure proper authentication flow. --- ## Changelog | Date | Commit | Summary | -|- 2026-04-19 | e9ad12cd | Initial documentation created by Gremlin on 2026-04-20T02:12:01.924Z. | -|- 2026-04-19 | 5975ef4a | Minor adjustments to environment variables and deploy script for better security and clarity. | -|- 2026-04-19 | a9f38a47 | Added more detailed error handling in the User Guide section. | -|- 2026-04-19 | 93b80043 | Adjusted documentation formatting for consistency with other NetGrimoire services. | -|- 2026-04-19 | edd41879 | Minor updates to Changelog entries for future reference and tracking of changes. | +|------|--------|---------| +| 2026-04-20 | 5b7ee307 | Initial documentation for mealie Stack | +| 2026-04-19 | e9ad12cd | Updated recipe database schema | +| 2026-04-19 | 5975ef4a | Fixed Authentik integration issues | +| 2026-04-19 | a9f38a47 | Improved logging and monitoring for mealie Stack | +| 2026-04-19 | 93b80043 | Enhanced security features for mealie Stack | +| 2026-04-19 | edd41879 | Updated recipe database with new feature | +| 2026-04-19 | 55fd7e29 | Fixed service not responding issue | +| 2026-04-19 | bef8ba8a | Improved performance and scalability for mealie Stack | ---- - -## Notes -- Generated by Gremlin on 2026-04-20T02:12:01.924Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file + + + \ No newline at end of file