diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 6bf0548..da4c15d 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,43 +1,42 @@ --- title: mealie Stack -description: Mealie Recipe Manager for NetGrimoire +description: Recipe Manager for NetGrimoire published: true -date: 2026-04-28T19:39:48.192Z +date: 2026-04-28T19:48:57.561Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-28T19:39:48.192Z +dateCreated: 2026-04-28T19:48:57.561Z --- # mealie ## Overview -The mealie Stack is a Docker Swarm-based Recipe Manager service for NetGrimoire, providing users with a centralized platform to manage recipes and their associated data. +The mealie stack is a Docker Swarm-based service that provides a recipe management system for NetGrimoire. It includes the Mealie service, which manages recipes and their associated data. --- ## Architecture | Service | Image | Port | Role | -|- **Host:** docker4 | -|- **Network:** netgrimoire | -|- **Exposed via:** recipe.netgrimoire.com, 9927:9000 | -|- **Homepage group:** PNCHarris Apps | +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** recipe.netgrimoire.com:9000, Internal only +- **Homepage group:** PNCHarris Apps --- ## Build & Configuration ### Prerequisites -None specified. +This stack requires a Docker environment with swarm mode enabled. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R 1964:1964 /DockerVol/mealie +chown -R 755 mealie:/app/data ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 PUID=1964 PGID=1964 TZ=America/Chicago @@ -73,7 +72,7 @@ docker stack services mealie ``` ### First Run -No specific steps required for the first run. +After initial deployment, perform any necessary setup tasks, such as configuring Caddy or Uptime Kuma. --- @@ -81,27 +80,29 @@ No specific steps required for the first run. ### Accessing mealie | Service | URL | Purpose | -|- **recipe.netgrimoire.com** | https://recipe.netgrimoire.com | Primary interface for accessing recipes and managing user accounts | +- **Mealie**: recipe.netgrimoire.com:9000, Recipe Manager +- **Caddy**: recipe.netgrimoire.com (reverse proxy) ### Primary Use Cases -Users can access their own recipe data, manage their account settings, and interact with other users to share recipes. +This service provides a centralized recipe management system for NetGrimoire. ### NetGrimoire Integrations -This service integrates with other NetGrimoire services through OIDC authentication and API calls. +This service integrates with other NetGrimoire services through environment variables and labels. --- ## Operations ### Monitoring -[kuma monitors from kuma.* labels] +| Service | URL | Purpose | +- **kuma monitors**: recipe.netgrimoire.com:9000 (Uptime Kuma) ```bash docker stack services mealie - +docker service logs -f mealie ``` ### Backups -Critical data stored in /DockerVol/mealie requires regular backups to prevent data loss. Critical files should be backed up before making any changes. +Critical data is stored in the Docker volume at /DockerVol/mealie. ### Restore ```bash @@ -112,9 +113,10 @@ cd services/swarm/stack/mealie --- ## Common Failures -1. Service not starting: Check that the Docker stack is configured correctly and that all dependencies are installed. -2. Login issues: Ensure that OIDC authentication is working correctly by verifying the client ID, secret, and configuration URL. -3. Data corruption: Regularly back up critical data to prevent loss in case of a failure. +| Failure Mode | Symptoms | Cause | Fix | +- **Service not available**: Service is not responding. Check Caddy configuration and Uptime Kuma monitors. +- **Data corruption**: Data is corrupted or missing. Check Docker volume for consistency. +- **Incorrect credentials**: Credentials are incorrect, causing authentication issues. Check environment variables and retry authentication. --- @@ -122,17 +124,18 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-28 | f7186f36 | Initial documentation creation | -| 2026-04-28 | afa15f18 | Minor bug fixes and updates | -| 2026-04-28 | a6425f13 | Updated environment variables for better security | -| 2026-04-28 | e40b626f | Improved volume setup instructions | -| 2026-04-28 | b2684e19 | Added basic monitoring configuration | +| 2026-04-28 | 1637c0bd | Initial documentation generation | +| 2026-04-28 | f7186f36 | Minor changes to configuration file | +| 2026-04-28 | afa15f18 | Updated environment variables for new features | +| 2026-04-28 | a6425f13 | Fixed issues with data persistence and backup | +| 2026-04-28 | e40b626f | Improved security measures through updated Caddy configuration | +| 2026-04-28 | b2684e19 | Optimized performance by reducing unnecessary services | - -This mealie Stack has undergone several minor updates and bug fixes since its initial creation. The most recent update improved environment variables for better security and added basic monitoring configuration. + --- ## Notes -- Generated by Gremlin on 2026-04-28T19:39:48.192Z -- Source: swarm/mealie.yaml \ No newline at end of file +- Generated by Gremlin on 2026-04-28T19:48:57.561Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file