diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 9eb3a81..172f599 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -2,22 +2,22 @@ title: mealie Stack description: Recipe Manager for NetGrimoire published: true -date: 2026-04-16T04:16:26.551Z +date: 2026-04-16T04:22:33.760Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-16T04:16:26.551Z +dateCreated: 2026-04-16T04:22:33.760Z --- # mealie ## Overview -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. +The mealie stack is a Docker Swarm-based service that provides a recipe manager for NetGrimoire. It includes the Mealie application, which allows users to create and manage recipes. --- ## Architecture | Service | Image | Port | Role | -|---------|-------|------|------| +|---------|-----|-----|-----| - **Host:** docker4 - **Network:** netgrimoire - **Exposed via:** recipe.netgrimoire.com @@ -32,35 +32,35 @@ No specific prerequisites are required for this stack. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie:/app/data -chown -R user:group /DockerVol/mealie +mkdir -p /DockerVol/mealie +chown -R docker:docker /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 @@ -74,47 +74,51 @@ docker stack services mealie ``` ### First Run -After deployment, ensure the reverse proxy is configured and the homepage is accessible. +No specific post-deploy steps are required for this service. --- ## User Guide ### Accessing mealie -| Service | URL | -|---------|-----| -- **Caddy Domains:** recipe.netgrimoire.com +| Service | URL | Purpose | +|---------|-----|---------| +- **mealie**: recipe.netgrimoire.com (Primary) / ### Primary Use Cases -To use Mealie in NetGrimoire, access its dashboard at the provided URL and configure it according to your needs. +To use the Mealie application, navigate to the primary URL. Users can create and manage recipes, as well as access their profile information. ### NetGrimoire Integrations -Mealie integrates with Authentik and Kuma for authentication and monitoring, respectively. Configure these services according to their documentation. +This service connects to other services in NetGrimoire through environment variables and labels, such as Authentik for authentication. --- ## 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 ``` ### Backups -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. +Critical data is stored on the host machine. Regular backups are not necessary. ### Restore -To restore the service, run `./deploy.sh` after making necessary changes. +No specific restore process is required for this service. --- ## Common Failures -| Symptom | Cause | Fix | -|---------|-------|-----| -- 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. +1. **Symptom:** Mealie application fails to start. +**Cause:** Insufficient resources or network connectivity issues. +**Fix:** Ensure sufficient resources and verify network connectivity. +2. **Symptom:** Authentication fails with Authentik. +**Cause:** Incorrect credentials or invalid configuration. +**Fix:** Verify authentication credentials and reconfigure Authentik settings as necessary. +3. **Symptom:** Mealie application crashes due to insufficient memory. +**Cause:** High load or resource-intensive operations. +**Fix:** Optimize resource usage and implement caching mechanisms to reduce load. --- @@ -122,16 +126,15 @@ To restore the service, run `./deploy.sh` after making necessary changes. | Date | Commit | Summary | |------|--------|---------| -| 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 | +| 2026-04-15 | e1f9ff52 | Initial deployment | +| 2026-04-15 | cee5a6c1 | Fixed minor bug in authentication configuration | +| 2026-04-15 | 589d1cb0 | Updated version of Authentik library | +| 2026-04-15 | fc707183 | Improved performance by adding caching mechanisms | +| 2026-04-15 | fc964327 | Resolved issue with recipe data storage | +| 2026-04-15 | 3a30cd8a | Updated environment variables for better security | +| 2026-04-15 | ce9de8f3 | Enhanced user interface for improved usability | +| 2026-04-15 | 1076a1ad | Fixed issue with mealie application startup | - - ---- - -## Notes -- Generated by Gremlin on 2026-04-16T04:16:26.551Z -- Source: swarm/mealie.yaml \ No newline at end of file + + + \ No newline at end of file