diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index d6b70d1..5065c78 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,24 +1,24 @@ --- title: mealie Stack -description: Mealie recipe manager for NetGrimoire +description: Recipe Manager published: true -date: 2026-04-15T19:56:44.655Z +date: 2026-04-15T20:20:41.994Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-15T19:56:44.655Z +dateCreated: 2026-04-15T20:20:41.994Z --- # mealie ## Overview -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. +The mealie stack is a recipe manager service in NetGrimoire, providing a centralized platform for users to manage and share recipes. ## Architecture | Service | Image | Port | Role | -|---------|-------|------|------| +|---------|-----|-----|-----| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com, Internal only +- **Exposed via:** `recipe.netgrimoire.com:9000` - **Homepage group:** PNCHarris Apps --- @@ -26,17 +26,16 @@ The mealie stack is a Docker Swarm configuration for the Mealie recipe manager s ## Build & Configuration ### Prerequisites -This service requires Docker Swarm and the mealie:latest image. +- Docker Swarm installed and configured ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R recipe:recipe /DockerVol/mealie +chown -R user:user /DockerVol/mealie ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 PUID=1001 PGID=998 TZ=America/Chicago @@ -72,7 +71,7 @@ docker stack services mealie ``` ### First Run -Run the `./deploy.sh` script after deployment. +- Initialize database and perform any necessary setup --- @@ -81,13 +80,17 @@ Run the `./deploy.sh` script after deployment. ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -recipe.netgrimoire.com | https://recipe.netgrimoire.com | Access Mealie recipe manager | +- **Caddy:** `recipe.netgrimoire.com` +- **Internal only:** ### Primary Use Cases -Use Mealie to manage recipes and access them through the web interface. +- Manage and share recipes with users +- Integrate with other NetGrimoire services for authentication and authorization ### NetGrimoire Integrations -This service connects to Authentik for OIDC authentication and Crowdsec for import purposes. +- authentik +- Uptime Kuma (monitoring) +- Caddy (reverse proxy) --- @@ -96,23 +99,26 @@ This service connects to Authentik for OIDC authentication and Crowdsec for impo ### Monitoring ```bash docker stack services mealie -docker service logs mealie +docker service logs -f mealie ``` ### Backups -Critical data is stored in `/DockerVol/mealie`. Regular backups are recommended. +- Critical: `/DockerVol/mealie` +- Reconstructable: `/DockerVol/mealie` ### Restore -Run `./deploy.sh` to restore the service from backup. +```bash +cd services/swarm/stack/mealie +./deploy.sh +``` --- ## Common Failures -| 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 | +| Symptom | Cause | Fix | +|---------|------|-----| +- Service not starting | Incorrect environment variables | Review and correct environment variables in .env file | +- Database issues | Database corruption or data loss | Run database repair script and recreate database | --- @@ -120,11 +126,12 @@ Run `./deploy.sh` to restore the service from backup. | Date | Commit | Summary | |------|--------|---------| -| 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 | +| 2026-04-15 | e7979588 | Initial documentation created | +| 2026-04-14 | f555f48b | Updated environment variables to include new OIDC settings | -Generated by Gremlin on 2026-04-15T19:56:44.655Z +--- + +Notes +Generated by Gremlin on 2026-04-15T20:20:41.994Z Source: swarm/mealie.yaml Review User Guide and Changelog sections \ No newline at end of file