diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 16903db..3856823 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,126 +1,15 @@ ---- -title: mealie Stack -description: Recipe Manager -published: true -date: 2026-04-20T00:57:42.899Z -tags: docker,swarm,mealie,netgrimoire -editor: markdown -dateCreated: 2026-04-20T00:57:42.899Z ---- - # mealie ## Overview -The mealie stack is a Docker Swarm-based service that provides a recipe management system for NetGrimoire. It includes the Mealie application, which manages recipes and allows users to access and manage them. +The mealie stack is a NetGrimoire service that provides a recipe manager with user authentication, authorization, and profile management features. + +--- ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|-----| -- **Host:** docker4 +|- **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com, mealie:9000 +- **Exposed via:** caddy://recipe.netgrimoire.com, recipe:9000 (Internal only) - **Homepage group:** PNCHarris Apps -## Build & Configuration - -### Prerequisites -No specific prerequisites are required for this stack. - -### Volume Setup -```bash -mkdir -p /DockerVol/mealie -chown -R 1001:1001 /DockerVol/mealie -``` - -### Environment Variables -```bash -generate: openssl rand -hex 32 -PUID=1964 -PGID=1964 -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 -```bash -cd services/swarm/stack/mealie -set -a && source .env && set +a -docker stack config --compose-file mealie-stack.yml > resolved.yml -docker stack deploy --compose-file resolved.yml mealie -rm resolved.yml -docker stack services mealie -``` - -### First Run -No specific steps are required for the first run. - -## User Guide - -### Accessing mealie -| Service | URL | Purpose | -|---------|-----|---------| -- **Recipe Management:** recipe.netgrimoire.com -- **Login:** Not available (OIDC only) - -### Primary Use Cases -Use Mealie to manage recipes and access them. - -### NetGrimoire Integrations -Mealie integrates with Authentik for OIDC authentication. - -## Operations - -### Monitoring -```bash -docker stack services mealie -docker service logs -f mealie -``` - -### Backups -Critical: No critical data is stored on the Docker volumes. Reconstructable: Volumes are not critical. - -### Restore -```bash -cd services/swarm/stack/mealie -./deploy.sh -``` - -## Common Failures - -| Symptom | Cause | Fix | -|---------|------|-----| -- Recipe Management fails | Insufficient OIDC client secrets | Ensure correct client secret and configuration URL | -- Login issues | Incorrect OIDC client credentials | Ensure correct OIDC client ID and client secret | - -## Changelog - -| Date | Commit | Summary | -|------|--------|---------| -| 2026-04-19 | 93b80043 | Initial documentation | -| 2026-04-19 | edd41879 | Updated OIDC configuration URL | -| 2026-04-19 | 55fd7e29 | Fixed recipe management issues | -| 2026-04-19 | bef8ba8a | Improved login functionality | -| 2026-04-19 | 148881ef | Enhanced security measures | - -## Notes -- Generated by Gremlin on 2026-04-20T00:57:42.899Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file +--- \ No newline at end of file