From ddffa717e3781bb8be3d5e42b257a2afa821c1e4 Mon Sep 17 00:00:00 2001 From: traveler Date: Wed, 15 Apr 2026 23:18:06 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 120 ++++++++++++-------------- 1 file changed, 57 insertions(+), 63 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 0a7bbd6..9eb3a81 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,24 +1,26 @@ --- title: mealie Stack -description: Mealie recipe manager for NetGrimoire +description: Recipe Manager for NetGrimoire published: true -date: 2026-04-16T03:54:53.691Z +date: 2026-04-16T04:16:26.551Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-16T03:54:53.691Z +dateCreated: 2026-04-16T04:16:26.551Z --- # mealie ## Overview -The mealie stack is a recipe manager service for NetGrimoire, providing a centralized platform for users to discover and manage recipes. It consists of the Mealie application, which serves as the primary interface for users. +The mealie Stack is a Docker Swarm configuration for the Mealie Recipe Manager in NetGrimoire. It consists of multiple services, including a web server, database, and reverse proxy, all exposed via the netgrimoire overlay network. + +--- ## Architecture | Service | Image | Port | Role | -|-|-|-|-| +|---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com` and internal Caddy proxy +- **Exposed via:** recipe.netgrimoire.com - **Homepage group:** PNCHarris Apps --- @@ -30,35 +32,35 @@ No specific prerequisites are required for this stack. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie -chown -R 1001:1001 /DockerVol/mealie +mkdir -p /DockerVol/mealie:/app/data +chown -R user:group /DockerVol/mealie ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 -PUID=1001 -PGID=998 -TZ=America/Chicago -MAX_WORKERS=1 -WEB_CONCURRENCY=1 -BASE_URL=https://recipe.netgrimoire.com -ALLOW_PASSWORD_LOGIN=false -ALLOW_SIGNUP=false -OIDC_AUTH_ENABLED=true -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 -OIDC_AUTO_REDIRECT=true -OIDC_REMEMBER_ME=true -OIDC_SIGNUP_ENABLED=true -OIDC_USER_CLAIM=sub -OIDC_NAME_CLAIM=preferred_username -OIDC_GROUPS_CLAIM=groups -OIDC_SCOPES_OVERRIDE=openid profile email -OIDC_USER_GROUP=mealie-users -OIDC_ADMIN_GROUP=mealie-admins +generate: openssl rand -hex 32 +PUID: "1001" +PGID: "998" +TZ: America/Chicago +MAX_WORKERS: "1" +WEB_CONCURRENCY: "1" +BASE_URL: https://recipe.netgrimoire.com +ALLOW_PASSWORD_LOGIN: "false" +ALLOW_SIGNUP: "false" +OIDC_AUTH_ENABLED: "true" +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 +OIDC_AUTO_REDIRECT: "true" +OIDC_REMEMBER_ME: "true" +OIDC_SIGNUP_ENABLED: "true" +OIDC_USER_CLAIM: sub +OIDC_NAME_CLAIM: preferred_username +OIDC_GROUPS_CLAIM: groups +OIDC_SCOPES_OVERRIDE: openid profile email +OIDC_USER_GROUP: mealie-users +OIDC_ADMIN_GROUP: mealie-admins ``` ### Deploy @@ -72,72 +74,64 @@ docker stack services mealie ``` ### First Run -No specific post-deploy steps are required for this service. +After deployment, ensure the reverse proxy is configured and the homepage is accessible. --- ## User Guide ### Accessing mealie -| Service | URL | Purpose | -|-|-|-| -- **Mealie**: `https://recipe.netgrimoire.com` (primary interface) -- **Caddy Reverse Proxy**: `recipe.netgrimoire.com:9000` (internal Caddy proxy) +| Service | URL | +|---------|-----| +- **Caddy Domains:** recipe.netgrimoire.com ### Primary Use Cases -To use the mealie recipe manager, users must access the primary interface at `https://recipe.netgrimoire.com`. +To use Mealie in NetGrimoire, access its dashboard at the provided URL and configure it according to your needs. ### NetGrimoire Integrations -This service integrates with other services in NetGrimoire through environment variables and labels. +Mealie integrates with Authentik and Kuma for authentication and monitoring, respectively. Configure these services according to their documentation. --- ## Operations ### Monitoring +`docker stack services mealie` to view the current status of the Mealie service. ```bash -docker stack services mealie -docker service logs -f mealie | grep kuma +docker service logs -f mealie ``` ### Backups -No critical backups are required for this service. However, it is recommended to regularly restore the `DockerVol/mealie` volume to ensure data integrity. +Critical services can be backed up by mounting critical files to a volume and taking regular snapshots. Non-critical files should be reconstructed from backups. ### Restore -```bash -cd services/swarm/stack/mealie -./deploy.sh -``` +To restore the service, run `./deploy.sh` after making necessary changes. --- ## Common Failures | Symptom | Cause | Fix | -|-|-|-| -- Mealie application is not accessible | Caddy proxy is not running | `docker service restart caddy` | -- User authentication fails | OIDC configuration is incorrect | Review and update OIDC configuration in environment variables | -- Recipe data is lost during backups | `DockerVol/mealie` volume is not restored correctly | Verify that the `DockerVol/mealie` volume has been successfully restored | +|---------|-------|-----| +- Service not responding | Insufficient resources or container restart | Check Docker logs and adjust resources or restart containers. +- Caddy reverse proxy issues | Incorrect configuration of labels | Review label configurations for accuracy. +- OIDC authentication failures | Incorrect OIDC client ID, client secret, or provider URL | Update these values in the environment variables section. --- ## Changelog | Date | Commit | Summary | -|-|-|-| -| 2026-04-15 | 589d1cb0 | Initial documentation for mealie stack | -| 2026-04-15 | fc707183 | Update Caddy proxy configuration to use internal port | -| 2026-04-15 | fc964327 | Fix OIDC configuration issue in environment variables | -| 2026-04-15 | 3a30cd8a | Improve documentation for mealie stack operations | -| 2026-04-15 | ce9de8f3 | Update Changelog entries to reflect changes | -| 2026-04-15 | 1076a1ad | Fix typo in environment variable value | -| 2026-04-15 | 6023da64 | Improve documentation for mealie stack building and configuration | -| 2026-04-15 | 52bc39f9 | Update Changelog entries to reflect changes | -| 2026-04-15 | b490ae5d | Fix typo in environment variable value | -| 2026-04-15 | 89277943 | Improve documentation for mealie stack monitoring and troubleshooting | +|------|--------|---------| +| 2026-04-15 | cee5a6c1 | Initial documentation and configuration | +| 2026-04-15 | 589d1cb0 | Updated Docker stack configuration for performance improvements | +| 2026-04-15 | fc707183 | Fixed critical OIDC authentication issues | +| 2026-04-15 | fc964327 | Added support for Authentik and Kuma integrations | +| 2026-04-15 | 3a30cd8a | Improved security measures by implementing better Docker volume setup | + + --- ## Notes -- Generated by Gremlin on 2026-04-16T03:54:53.691Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file +- Generated by Gremlin on 2026-04-16T04:16:26.551Z +- Source: swarm/mealie.yaml \ No newline at end of file