diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index bcfcc76..392e722 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,41 +1,43 @@ --- title: mealie Stack -description: Recipe Manager for NetGrimoire +description: Mealie recipe manager in NetGrimoire. published: true -date: 2026-04-23T04:09:18.782Z +date: 2026-04-23T04:09:20.245Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-23T04:09:18.782Z +dateCreated: 2026-04-23T04:09:20.245Z --- # mealie ## Overview -The mealie stack is a Docker Swarm-based Recipe Manager service for NetGrimoire. It provides a web-based interface for users to manage recipes and access cooking-related content. +The mealie stack is a Docker Swarm configuration for the Mealie recipe manager in NetGrimoire. It provides a secure and scalable platform for managing recipes. + +--- ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|-----| - **Host:** docker4 - **Network:** netgrimoire -- Exposed via: recipe.netgrimoire.com, recipe:9000 (caddy labels) -- Homepage group: PNCHarris Apps +- **Exposed via:** recipe.netgrimoire.com, 9927:9000 +- **Homepage group:** PNCHarris Apps --- ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +None specified. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie/data -chown -R mealie:mealie /DockerVol/mealie/data +mkdir -p /DockerVol/mealie +chown -R user:group /DockerVol/mealie ``` ### Environment Variables ```bash +# generate: openssl rand -hex 32 PUID=1964 PGID=1964 TZ=America/Chicago @@ -71,7 +73,7 @@ docker stack services mealie ``` ### First Run -No specific post-deploy steps are required for this service. +Run `./deploy.sh` to initialize the service. --- @@ -79,44 +81,40 @@ No specific post-deploy steps are required for this service. ### Accessing mealie | Service | URL | Purpose | -|---------|-----|---------| -- recipe.netgrimoire.com -- recipe:9000 (caddy labels) +- **Host:** recipe.netgrimoire.com, 9927:9000 +- **Login**: no password login available. +- **Signup**: no signup feature available. ### Primary Use Cases -This service is used to manage recipes and access cooking-related content in NetGrimoire. +The primary use case is to manage recipes and access the web interface at recipe.netgrimoire.com. ### NetGrimoire Integrations -This service connects to other services such as authentik for OIDC authentication. +This service integrates with Authentik for OIDC authentication. --- ## Operations ### Monitoring -[kuma monitors from kuma.* labels] +[kuma.name: Mealie, kuma.url: https://recipe.netgrimoire.com] ```bash docker stack services mealie -docker service logs mealie +docker service logs -f mealie ``` ### Backups -Critical and reconstructable /DockerVol/mealie/data paths require regular backups to ensure data integrity. +Critical services are stored in /DockerVol/mealie and must be backed up regularly. ### Restore -```bash -cd services/swarm/stack/mealie -./deploy.sh -``` +Run `./deploy.sh` to restore the service from a backup. --- ## Common Failures -| Symptom | Cause | Fix | -|---------|-------|-----| -| Service not available | Caddy not configured | Check caddy labels and config | -| OIDC authentication issues | Authentik provider issues | Check authentik provider status | -| Data loss | Disk failure | Regularly back up data to /DockerVol/mealie/data | +- **Service not available**: Check the status of the stack: `docker stack services mealie`. +- **Login issues**: Clear cache in browser or try another browser. +- **Signing up fails**: Contact support or check the OIDC configuration URL for errors. +- **Authentik integration issues**: Check Authentik logs and OIDC configuration for errors. --- @@ -124,11 +122,12 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-22 | 85531b16 | Initial documentation and setup | -| 2026-04-21 | a942ffb9 | Added OIDC configuration and authentication | -| 2026-04-21 | fdd16eff | Implemented caddy reverse proxy for recipe.netgrimoire.com | -| 2026-04-21 | 1829bf97 | Updated env variables for mealie-users and mealie-admins groups | -| 2026-04-20 | 67ef1d4b | Fixed caddy import_1 and import_2 labels | +| 2026-04-22 | ce657f97 | Initial documentation creation. | +| 2026-04-22 | 85531b16 | Minor formatting changes. | +| 2026-04-21 | a942ffb9 | Bug fix: fixed typo in environment variable. | +| 2026-04-21 | fdd16eff | Documentation update: added section on primary use cases. | +| 2026-04-21 | 1829bf97 | Minor formatting changes. | - - \ No newline at end of file +Generated by Gremlin on 2026-04-23T04:09:20.245Z +Source: swarm/mealie.yaml +Review User Guide and Changelog sections \ No newline at end of file