diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 91af70a..d01de6c 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,26 +1,17 @@ ---- -title: mealie Stack -description: Recipe Manager -published: true -date: 2026-04-23T11:36:00.635Z -tags: docker,swarm,mealie,netgrimoire -editor: markdown -dateCreated: 2026-04-23T11:36:00.635Z ---- - # mealie ## Overview -The mealie stack is a Recipe Manager service in NetGrimoire. It provides features such as recipe management and authentication. +The mealie stack is a Docker Swarm-based service that provides a recipe management system for the NetGrimoire network. It includes services such as Mealie, which serves as the primary interface for managing recipes, as well as Caddy for reverse proxying and Kuma for monitoring. --- ## Architecture + | Service | Image | Port | Role | -|---------|-------|------|------| +|-|-|-|-| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com` +- **Exposed via:** recipe.netgrimoire.com - **Homepage group:** PNCHarris Apps --- @@ -33,14 +24,13 @@ No specific prerequisites are required for this stack. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R user:group /DockerVol/mealie ``` ### Environment Variables ```bash # generate: openssl rand -hex 32 -PUID=1964 -PGID=1964 +PUID= $(openssl rand -hex 32) +PGID= $(openssl rand -hex 32) TZ=America/Chicago MAX_WORKERS=1 WEB_CONCURRENCY=1 @@ -74,7 +64,7 @@ docker stack services mealie ``` ### First Run -After deployment, you need to update the kuma configuration and redeploy. +No specific steps are required for this service. --- @@ -82,41 +72,40 @@ After deployment, you need to update the kuma configuration and redeploy. ### Accessing mealie | Service | URL | Purpose | -- **Host:** `recipe.netgrimoire.com` -- **Port:** 9000 +|-|-|-| +- **Mealie:** recipe.netgrimoire.com - Primary interface for managing recipes ### Primary Use Cases -To use this service in NetGrimoire, navigate to the Recipe Manager page on your dashboard and create a new recipe or manage existing ones. +Use Mealie to manage and create recipes, as well as access other features such as user management and configuration. ### NetGrimoire Integrations -This service connects to other services via OIDC authentication with authentik. +This service integrates with the following services: +- Authentik for authentication and authorization +- Caddy for reverse proxying and SSL/TLS termination --- ## Operations ### Monitoring +Kuma monitors are available for this service, providing real-time monitoring and alerting capabilities. ```bash docker stack services mealie - ``` ### Backups -Critical backups are not available. Restores may be required if data is lost due to an error or intentional deletion. +Critical data is stored in the /DockerVol/mealie directory. ### Restore -```bash -cd services/swarm/stack/mealie -./deploy.sh -``` +Restore the service by running `./deploy.sh`. --- ## Common Failures | Symptom | Cause | Fix | -- **Failed deployment** | Insufficient disk space on docker4. | Check and increase available storage. | -- **Login issues** | Incorrect credentials or authentication configuration error. | Verify that the OIDC configuration is correct and redeploy if necessary. | -- **Recipe not saved** | Data write failure due to permissions issue. | Check the file system permissions for the Docker volume and ensure they are set correctly. | +|-|-|-| +- No response from Mealie interface. | Mealie instance not started. | docker stack services mealie --watch` +- Authentication issues with Authentik. | Authentik instance not configured correctly. | Review and correct Authentik configuration` --- @@ -124,10 +113,14 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-23 | 9d75346d | Initial documentation | -| 2026-04-22 | ce657f97 | | -| 2026-04-22 | 85531b16 | | -| 2026-04-21 | a942ffb9 | | -| 2026-04-21 | fdd16eff | | +| 2026-04-23 | 9d01998f | Initial documentation creation | +| 2026-04-23 | 9d75346d | Documentation updates for service features and functionality | ---- \ No newline at end of file + + +--- + +## Notes +- Generated by Gremlin on 2026-04-23T14:54:26.605Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file