diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md new file mode 100644 index 0000000..4a8672c --- /dev/null +++ b/Netgrimoire/Services/mealie/mealie.md @@ -0,0 +1,140 @@ +--- +title: mealie Stack +description: Recipe Manager for NetGrimoire +published: true +date: 2026-04-15T03:08:49.203Z +tags: docker,swarm,mealie,netgrimoire +editor: markdown +dateCreated: 2026-04-15T03:08:49.203Z +--- + +# mealie + +## Overview +The mealie Stack is a Recipe Manager service for NetGrimoire, responsible for managing recipe data and providing a frontend interface for users to access and interact with recipes. + +## Architecture +| Service | Image | Port | Role | +|---------|-------|------|------| +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** recipe.netgrimoire.com, 9925:9000 (Internal) +- **Homepage group:** PNCHarris Apps + +--- + +## Build & Configuration + +### Prerequisites +None + +### Volume Setup +```bash +mkdir -p /DockerVol/mealie +chown -R ubuntu:ubuntu /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 +``` + +### 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 +After the initial deployment, it's recommended to run `./deploy.sh` to ensure that all necessary configurations and setup are completed. + +--- + +## User Guide + +### Accessing mealie +| Service | URL | Purpose | +|---------|-----|---------| +- **recipe:** http://recipe:9000 + +### Primary Use Cases +To access the recipe data, simply navigate to the URL provided above. + +### NetGrimoire Integrations +The mealie Stack integrates with Authentik for OIDC authentication and with Uptime Kuma for monitoring. + +--- + +## Operations + +### Monitoring +[kuma.recipe.http.name=Mealie] +```bash +docker stack services mealie + +``` + +### Backups +Critical data should be backed up to /DockerVol/mealie. Non-critical data can be backed up to a separate location. + +### Restore +```bash +cd services/swarm/stack/mealie +./deploy.sh +``` + +--- + +## Common Failures +| Failure | Symptom | Cause | Fix | +|--------|---------|------|-----| +| Service not available | Unable to access recipe data | Service is down or not running | Check service logs and restart the service | +| Authentik connection issues | OIDC authentication fails | Authentik server is offline or credentials are incorrect | Check Authentik status and verify credentials | + +--- + +## Changelog + +| Date | Commit | Summary | +|------|--------|---------| +| 2026-04-14 | 49688e1c | Initial documentation creation | +| 2026-01-20 | 061ab0c2 | Improved environment variable setup for OIDC authentication | +| 2026-01-10 | 1a374911 | Initial deployment of mealie Stack | + +--- + +## Notes +- Generated by Gremlin on 2026-04-15T03:08:49.203Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file