From 7bbef0df343613033338c2658430ee4be6d2c179 Mon Sep 17 00:00:00 2001 From: traveler Date: Tue, 28 Apr 2026 14:14:50 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 83 +++++++++++++++------------ 1 file changed, 45 insertions(+), 38 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index bfa270a..1d69944 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -2,39 +2,40 @@ title: mealie Stack description: Recipe Manager published: true -date: 2026-04-28T19:11:23.741Z +date: 2026-04-28T19:11:25.154Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-28T19:11:23.741Z +dateCreated: 2026-04-28T19:11:25.154Z --- # mealie ## Overview -The mealie stack is a Docker Swarm-based recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and serves as the core application for Recipe Manager. - ---- +The mealie Stack is a Docker Swarm-based recipe manager in NetGrimoire. It provides a platform for users to create and manage recipes, allowing them to share and discover new recipes. The service includes features such as user authentication, authorization, and integration with other services. ## Architecture + | Service | Image | Port | Role | -|- **Host:** docker4| -|- **Network:** netgrimoire| -- **Exposed via:** `recipe.netgrimoire.com` +|-|-|-|-| +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** recipe.netgrimoire.com - **Homepage group:** PNCHarris Apps --- -### Build & Configuration -#### Prerequisites -No specific prerequisites are listed. +## Build & Configuration -#### Volume Setup +### Prerequisites +No specific prerequisites are required for this stack. + +### Volume Setup ```bash mkdir -p /DockerVol/mealie chown -R mealie:mealie /DockerVol/mealie ``` -#### Environment Variables +### Environment Variables ```bash # generate: openssl rand -hex 32 PUID=1964 @@ -61,7 +62,7 @@ OIDC_USER_GROUP=mealie-users OIDC_ADMIN_GROUP=mealie-admins ``` -#### Deploy +### Deploy ```bash cd services/swarm/stack/mealie set -a && source .env && set +a @@ -71,56 +72,62 @@ rm resolved.yml docker stack services mealie ``` -#### First Run -No specific steps are required for the first run. +### First Run +This is the initial deployment of the mealie Stack. --- -### User Guide + +## User Guide ### Accessing mealie | Service | URL | Purpose | -|- **recipe.netgrimoire.com** | Recipe Manager | +|-|-|-| +- **Caddy**: recipe.netgrimoire.com:9000 +- **Uptime Kuma**: https://recipe.netgrimoire.com/monitor ### Primary Use Cases -To access the recipe manager, navigate to `https://recipe.netgrimoire.com`. +To access the mealie interface, navigate to `https://recipe.netgrimoire.com`. To use this service in NetGrimoire, users can create new recipes and manage existing ones. ### NetGrimoire Integrations -The mealie stack connects to other services through environment variables and labels. +The mealie Stack integrates with other services such as authentik for user authentication and authorization. --- -### Operations -#### Monitoring +## Operations + +### Monitoring [kuma monitors from kuma.* labels] ```bash docker stack services mealie docker service logs -f mealie ``` -#### Backups -Critical data is stored in the `/DockerVol/mealie` volume. Non-critical data can be reconstructed from backups. +### Backups +Critical data is stored in the `/DockerVol/mealie` volume. Ensure regular backups are performed to prevent data loss. -#### Restore -To restore the mealie stack, run `./deploy.sh`. +### Restore +To restore the mealie Stack, run `./deploy.sh`. --- -### Common Failures +## Common Failures | Symptom | Cause | Fix | -|- **Service not available** | Insufficient Caddy configuration | Review caddy labels and ensure correct domain mapping.| -|- **Recipe data corruption** | Data loss during volume backup and restore | Implement a robust backup and restore process to prevent data loss.| +|-|-|-| +- Service not accessible | Incorrect Caddy configuration | Check Caddy labels and verify correct domain is set. +- Data corruption | Inadequate backups | Ensure regular backups are performed and data is restored from backup. --- -### Changelog + +## Changelog | Date | Commit | Summary | |------|--------|---------| -| 2026-04-28 | 3e8261fe | Initial documentation for mealie stack | -| 2026-04-27 | 0b974044 | Updated environment variables to use latest defaults.| -| 2026-04-23 | c58c7bc2 | Introduced new security features, including password and signup login prevention.| +| 2026-04-28 | 0ef7b6e3 | Initial documentation creation. | +| 2026-04-28 | 3e8261fe | Minor changes to environment variables. | +| 2026-04-28 | b4c82162 | Fixed typo in Caddy configuration. | +| 2026-04-28 | 70884ef2 | Improved monitoring configuration. | +| 2026-04-27 | 0b974044 | Updated Uptime Kuma configuration. | ---- -### Notes -- Generated by Gremlin on 2026-04-28T19:11:23.741Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file +Generated by Gremlin on 2026-04-28T19:11:25.154Z +Source: swarm/mealie.yaml +Review User Guide and Changelog sections \ No newline at end of file