diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 744ca50..c5a96f2 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,26 +1,23 @@ --- title: mealie Stack -description: Recipe Manager +description: Recipe Manager for NetGrimoire published: true -date: 2026-04-15T23:07:29.519Z +date: 2026-04-15T23:13:44.661Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-15T23:07:29.519Z - +dateCreated: 2026-04-15T23:13:44.661Z --- # mealie ## Overview -The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It includes the mealie service, which provides a web interface for managing recipes. - ---- +The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and their associated data. ## Architecture | Service | Image | Port | Role | - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** `recipe.netgrimoire.com` +- **Exposed via:** `recipe.netgrimoire.com`, `caddy:9000` - **Homepage group:** PNCHarris Apps --- @@ -28,11 +25,12 @@ The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It inclu ## Build & Configuration ### Prerequisites -To deploy the mealie stack, you need to have Docker Swarm and Caddy installed. +No specific prerequisites are required for this stack. ### Volume Setup ```bash -mkdir -p /DockerVol/mealie:/app/data +mkdir -p /DockerVol/mealie +chown -R docker4:docker4 /DockerVol/mealie ``` ### Environment Variables @@ -73,10 +71,7 @@ docker stack services mealie ``` ### First Run -After the initial deployment, you need to run the following command to initialize the database: -```bash -./init.sh -``` +This service does not require any specific setup after deployment. --- @@ -84,11 +79,55 @@ After the initial deployment, you need to run the following command to initializ ### Accessing mealie | Service | URL | Purpose | -- **Host:** `recipe.netgrimoire.com` -- **Port:** 9000 (internal) or `recipe.netgrimoire.com` (external) +- **Recipe Manager:** `https://recipe.netgrimoire.com` +- **Caddy Proxy:** `caddy:9000` ### Primary Use Cases -To use the mealie service, you need to sign up for an account and access the web interface. +To manage recipes and their associated data, navigate to the Recipe Manager service. ### NetGrimoire Integrations -The mealie service connects to other services in NetGrimoire through environment variables and labels. \ No newline at end of file +The mealie stack integrates with Authentik for OIDC authentication. + +--- + +## Operations + +### Monitoring +```bash +docker stack services mealie +docker service logs -f mealie +``` + +### Backups +Critical data should be backed up on the `/DockerVol/mealie` volume. + +### Restore +To restore from a backup, redeploy the `mealie-stack.yml` file using `./deploy.sh`. + +--- + +## Common Failures +- **Symptom:** Mealie fails to start. +- **Cause:** Insecure environment variables or Docker image issues. +- **Fix:** Review and update environment variables and Docker images. + +--- + +## Changelog + +| Date | Commit | Summary | +|------|--------|---------| +| 2026-04-15 | b9007e9e | Initial documentation. | +| 2026-04-15 | 58549b2e | Added Caddy reverse proxy configuration. | +| 2026-04-15 | e79fb0ad | Updated OIDC client ID and secret. | +| 2026-04-15 | d2d9ac52 | Improved Docker volume setup security. | +| 2026-04-15 | e7979588 | Enhanced NetGrimoire integration with Authentik. | + + + +--- + +## Notes +- Generated by Gremlin on 2026-04-15T23:13:44.661Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file