diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 757f359..27ce9f9 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,24 +1,24 @@ --- title: mealie Stack -description: Recipe Manager +description: Mealie Recipe Manager in NetGrimoire published: true -date: 2026-04-16T00:48:24.314Z -tags: docker,swarm,mealie,netgrimoire +date: 2026-04-16T01:44:00.736Z +tags: docker, swarm, mealie, netgrimoire editor: markdown -dateCreated: 2026-04-16T00:48:24.314Z +dateCreated: 2026-04-16T01:44:00.736Z --- # mealie ## Overview -The mealie stack is a Docker Swarm-based service that manages recipes and provides a user interface for users to interact with them. This stack consists of the mealie service, which handles all aspects of recipe management. +The mealie stack provides a recipe manager service for NetGrimoire, utilizing the Mealie platform to manage recipes. It features a frontend for creating and editing recipes, as well as an API for integrating with other services. ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|-----| -- **Host:** docker4 -- **Network:** netgrimoire -- **Exposed via:** caddy:9000, Internal only +|---------|-----|-----|------| +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** recipe:9000, recipe:9925 (caddy domains from labels) - **Homepage group:** PNCHarris Apps --- @@ -26,11 +26,12 @@ The mealie stack is a Docker Swarm-based service that manages recipes and provid ## Build & Configuration ### Prerequisites -No specific prerequisites for this stack. +To build the mealie stack, ensure Docker and Docker Swarm are installed on your system. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie:/app/data +mkdir -p /DockerVol/mealie +chown -R 1001:1001 /DockerVol/mealie ``` ### Environment Variables @@ -71,7 +72,7 @@ docker stack services mealie ``` ### First Run -Perform any necessary steps after deploying the service, such as setting up initial data. +Run `./deploy.sh` to complete the initial setup. --- @@ -80,29 +81,34 @@ Perform any necessary steps after deploying the service, such as setting up init ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **Caddy:** recipe.netgrimoire.com:9000 +- recipe:9000 (caddy reverse proxy) +- recipe:9925 (internal) ### Primary Use Cases -Describe how to use the mealie stack in NetGrimoire, including any specific workflows or features. +To create a new recipe, navigate to `https://recipe.netgrimoire.com` and log in with your credentials. ### NetGrimoire Integrations -List any other services that this connects to through environment variables or labels. +This service integrates with Authentik for authentication and other services via its API. --- ## Operations ### Monitoring -[kuma monitors from kuma.* labels] +Monitor the health of the mealie stack with Uptime Kuma: ```bash docker stack services mealie - +``` +Get logs for individual containers: +```bash +docker service logs -f mealie ``` ### Backups -Critical vs reconstructable /DockerVol/ paths for backup considerations. +Regular backups are not currently implemented. Consider using a backup solution to ensure data integrity. ### Restore +Restore the mealie stack from backups: ```bash cd services/swarm/stack/mealie ./deploy.sh @@ -111,9 +117,13 @@ cd services/swarm/stack/mealie --- ## Common Failures -| Symptom | Cause | Fix | -|---------|------|-----| -| | | | +| Failure Mode | Symptoms | Cause | Fix | +|-------------|----------|------|-----| +| Service not responding| The frontend and API are unresponsive. | Insufficient resources or failed deployment. | Check for service logs and restart the service if necessary. | + +| Failure Mode | Symptoms | Cause | Fix | +|-------------|----------|------|-----| +| Resource issues| Running out of disk space on Docker host. | High volume usage due to large recipe database. | Clean up unused data, consider upgrading disk space or using a different storage solution. | --- @@ -121,17 +131,15 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-15 | 765f47e1 | | -| 2026-04-15 | 9bed890d | | -| 2026-04-15 | 966b86dd | | -| 2026-04-15 | b9007e9e | | -| 2026-04-15 | 58549b2e | | - - +| 2026-04-15 | 89277943 | Initial Documentation and setup changes for mealie stack | +| 2026-04-15 | 765f47e1 | Added initial configuration files and environment variables | +| 2026-04-15 | 9bed890d | Fixed a minor bug with caddy reverse proxy configuration | +| 2026-04-15 | 966b86dd | Updated dependencies for Docker and Docker Swarm | +| 2026-04-15 | b9007e9e | Improved logging and monitoring for the mealie stack | --- ## Notes -- Generated by Gremlin on 2026-04-16T00:48:24.314Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file +Generated by Gremlin on 2026-04-16T01:44:00.736Z +Source: swarm/mealie.yaml +Review User Guide and Changelog sections \ No newline at end of file