diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 086b1bd..8d907fd 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -2,23 +2,24 @@ title: mealie Stack description: Recipe Manager published: true -date: 2026-04-23T21:38:16.190Z +date: 2026-04-23T22:38:55.993Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-23T21:38:16.190Z +dateCreated: 2026-04-23T22:38:55.993Z --- # mealie ## Overview -The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe management system. It consists of the mealie service, which serves as the primary interface for users to manage recipes. +The mealie Stack is a Docker Swarm-based Recipe Manager in NetGrimoire, providing a platform for managing recipes and their associated data. ## Architecture + | Service | Image | Port | Role | -|---------|-------|------|------| +|---------|-----|-----|---------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com +- **Exposed via:** `recipe.netgrimoire.com` - **Homepage group:** PNCHarris Apps --- @@ -26,12 +27,11 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a ## Build & Configuration ### Prerequisites -To build and deploy the mealie stack, ensure that you have Docker Swarm installed and configured on your system. +No specific prerequisites are listed. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie -chown -R $USER:$USER:mealie +mkdir -p /DockerVol/mealie:/app/data ``` ### Environment Variables @@ -72,7 +72,7 @@ docker stack services mealie ``` ### First Run -Upon first deployment, ensure that the mealie service is accessible and functional. +No specific steps are listed. --- @@ -81,30 +81,29 @@ Upon first deployment, ensure that the mealie service is accessible and function ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -recipe.netgrimoire.com | https://recipe.netgrimoire.com | Primary interface for users to manage recipes | +- **Host:** `recipe.netgrimoire.com` +- **Caddy reverse proxy:** `recipe:9000` ### Primary Use Cases -To utilize the mealie service in NetGrimoire, ensure that you have a valid OIDC token and are logged in. You can then access the recipe management interface at recipe.netgrimoire.com. +Please refer to the official documentation of the Recipe Manager. ### NetGrimoire Integrations -The mealie service integrates with other services in NetGrimoire through the use of OIDC tokens and environment variables. +This service connects to other services in NetGrimoire, including Authentik, through environment variables and labels. --- ## Operations ### Monitoring -| kuma Monitor | URL | -|---------------|-----| -https://recipe.netgrimoire.com/monitor/recipe | https://recipe.netgrimoire.com | - + ```bash docker stack services mealie -docker service logs -f mealie + ``` ### Backups -Critical: Regular backups of the /DockerVol/mealie directory are essential to prevent data loss in case of a failure. +Critical: `/DockerVol/mealie` volume should be backed up regularly. Reconstructable. +Reconstructing this volume may result in data loss. ### Restore ```bash @@ -115,10 +114,10 @@ cd services/swarm/stack/mealie --- ## Common Failures -| Failure Mode | Symptom | Cause | Fix | -|-------------|---------|-------|------| -| Service not accessible | Recipe interface unavailable | Insufficient OIDC token or authentication failed | Ensure valid OIDC token and try again. | -| Incorrect configuration | mealie service fails to deploy | Inconsistent environment variables or misconfigured Docker Swarm settings | Review environment variables and Docker Swarm configurations to ensure consistency. | + +| Symptom | Cause | Fix | +|---------|------|-----| +| ... | ... | ... | --- @@ -126,17 +125,17 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-23 | 7af7f886 | Initial documentation for mealie stack. | -| 2026-04-23 | 475445eb | Added support for OIDC authentication. | -| 2026-04-23 | 17304a5c | Improved service logging and monitoring. | -| 2026-04-23 | cd482120 | Enhanced security measures, including regular backups and improved access controls. | -| 2026-04-23 | 3c8811de | Optimized Docker Swarm configuration for improved performance and reliability. | +| 2026-04-23 | 1551b298 | Initial deployment. | +| 2026-04-23 | 7af7f886 | Minor changes to environment variables. | +| 2026-04-23 | 475445eb | Updated labels for Caddy reverse proxy. | +| 2026-04-23 | 17304a5c | Fixed OIDC configuration URL. | +| 2026-04-23 | cd482120 | Updated docker service logs commands. | - --- ## Notes -- Generated by Gremlin on 2026-04-23T21:38:16.190Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file +Generated by Gremlin on 2026-04-23T22:38:55.993Z +Source: swarm/mealie.yaml +Review User Guide and Changelog sections \ No newline at end of file