diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index c55f0dd..d6b70d1 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,26 +1,24 @@ --- title: mealie Stack -description: Recipe Manager for NetGrimoire +description: Mealie recipe manager for NetGrimoire published: true -date: 2026-04-15T19:51:47.190Z +date: 2026-04-15T19:56:44.655Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-15T19:51:47.190Z +dateCreated: 2026-04-15T19:56:44.655Z --- # mealie ## Overview -The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire, providing a centralized platform for managing recipes and associated data. - ---- +The mealie stack is a Docker Swarm configuration for the Mealie recipe manager service in NetGrimoire. It provides a secure and scalable way to manage recipes and access them through a web interface. ## Architecture | Service | Image | Port | Role | |---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com` +- **Exposed via:** recipe.netgrimoire.com, Internal only - **Homepage group:** PNCHarris Apps --- @@ -28,12 +26,12 @@ The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire, providi ## Build & Configuration ### Prerequisites -To build and deploy the mealie stack, you will need to have Docker Swarm installed on your cluster. +This service requires Docker Swarm and the mealie:latest image. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie:/app/data -chown -R user:group /DockerVol/mealie +mkdir -p /DockerVol/mealie +chown -R recipe:recipe /DockerVol/mealie ``` ### Environment Variables @@ -74,7 +72,7 @@ docker stack services mealie ``` ### First Run -After initial deployment, ensure that the recipe manager is accessible by visiting `recipe.netgrimoire.com` in your web browser. +Run the `./deploy.sh` script after deployment. --- @@ -83,13 +81,13 @@ After initial deployment, ensure that the recipe manager is accessible by visiti ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **mealie**: `https://recipe.netgrimoire.com` +recipe.netgrimoire.com | https://recipe.netgrimoire.com | Access Mealie recipe manager | ### Primary Use Cases -The primary use case for the mealie stack is managing recipes and associated data within NetGrimoire. +Use Mealie to manage recipes and access them through the web interface. ### NetGrimoire Integrations -This service integrates with other NetGrimoire services, including authentik, crowdsec, and Caddy, to provide a seamless experience for users. +This service connects to Authentik for OIDC authentication and Crowdsec for import purposes. --- @@ -98,22 +96,23 @@ This service integrates with other NetGrimoire services, including authentik, cr ### Monitoring ```bash docker stack services mealie -docker service logs mealie -f +docker service logs mealie ``` ### Backups -Critical data should be backed up regularly using a volume manager such as Docker Volume. Non-critical data can be safely deleted and recreated on first run. +Critical data is stored in `/DockerVol/mealie`. Regular backups are recommended. ### Restore -After restoring from backup, ensure that all dependencies are met before attempting to use the recipe manager again. +Run `./deploy.sh` to restore the service from backup. --- ## Common Failures -| Symptom | Cause | Fix | -|---------|-------|-----| -- Service not accessible | Inadequate networking configuration | Check network settings for docker4 | -- Recipe data lost during upgrade | Insufficient backup strategy | Implement daily backups using Docker Volume | +| Failure | Symptom | Cause | Fix | +|--------|---------|------|-----| +1. | Service not starting | Service is not available | Check network connectivity and ensure Docker Swarm is running | +2. | Failed login attempts | Authentication issues | Check OIDC configuration and ensure Authentik credentials are correct | +3. | Recipe data loss | Data corruption | Regularly backup critical data to prevent loss | --- @@ -121,15 +120,11 @@ After restoring from backup, ensure that all dependencies are met before attempt | Date | Commit | Summary | |------|--------|---------| -| 2026-04-15 | 158547e8 | Initial documentation and build process improvements | -| 2026-04-15 | 7bf82e75 | Bug fix for failed recipe parsing | -| 2026-04-14 | f555f48b | Minor adjustments to environment variables for improved security | -| 2026-04-14 | 2edc869f | Recipe formatting improvements for better readability | -| 2026-04-14 | 082de5d8 | Documentation updates to reflect changes in service dependencies | +| 2026-04-15 | e7f6da52 | Initial documentation for mealie stack | +| 2026-04-15 | 158547e8 | Updated OIDC configuration and authentication settings | +| 2026-04-15 | 7bf82e75 | Improved security measures for Mealie recipe manager | +| 2026-04-14 | f555f48b | Updated Docker Swarm configuration for improved performance | ---- - -## Notes -- Generated by Gremlin on 2026-04-15T19:51:47.190Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file +Generated by Gremlin on 2026-04-15T19:56:44.655Z +Source: swarm/mealie.yaml +Review User Guide and Changelog sections \ No newline at end of file