From 777e4b20e35cab6395deb7cf5f5b3d7e80dc24f9 Mon Sep 17 00:00:00 2001 From: traveler Date: Mon, 20 Apr 2026 15:45:57 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 80 +++++++++++++-------------- 1 file changed, 38 insertions(+), 42 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 705fa8b..3f47ccd 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,33 +1,36 @@ --- title: mealie Stack -description: Recipe Manager for NetGrimoire +description: Recipe Manager published: true -date: 2026-04-20T20:31:23.592Z +date: 2026-04-20T20:43:54.951Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-20T20:31:23.592Z +dateCreated: 2026-04-20T20:43:54.951Z + --- # mealie ## Overview -The mealie stack is a Docker Swarm service that provides a recipe manager for NetGrimoire. It consists of the mealie service, which serves as the primary interface for managing recipes, and is configured to expose its services via Caddy reverse proxy. +The mealie Stack is a Docker Swarm configuration for managing a Recipe Manager in NetGrimoire. It consists of the Mealie service, which provides a web-based interface for creating and managing recipes. + +--- ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|-----| -- **mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | Internal (Caddy) | -- Host: docker4 -- Network: netgrimoire -- Exposed via: recipe.netgrimoire.com (via Caddy reverse proxy) -- Homepage group: PNCHarris Apps +- **Mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | / | Recipe Manager | + +--- +Exposed via: recipe.netgrimoire.com + +Homepage group: PNCHarris Apps --- ## Build & Configuration ### Prerequisites -No prerequisites are required for this stack. +No specific prerequisites are required for this stack. ### Volume Setup ```bash @@ -73,7 +76,7 @@ docker stack services mealie ``` ### First Run -Perform any necessary initial setup after deployment. +Perform any necessary initial setup, such as configuring the database or seeding the database with sample data. --- @@ -81,14 +84,11 @@ Perform any necessary initial setup after deployment. ### Accessing mealie | Service | URL | Purpose | -|---------|-----|---------| -- **mealie:** https://recipe.netgrimoire.com (via Caddy reverse proxy) | +- **Mealie:** recipe.netgrimoire.com | Recipe Manager | -### Primary Use Cases -Please refer to the official mealie documentation for usage instructions. - -### NetGrimoire Integrations -This service integrates with other NetGrimoire services through environment variables and labels. Please see the `environment` section of the `mealie-stack.yml` file for more information. +--- +Primary Use Cases +This service is intended for use in managing recipes within NetGrimoire. Users can create, edit, and delete recipes, as well as manage user permissions and access control. --- @@ -97,27 +97,26 @@ This service integrates with other NetGrimoire services through environment vari ### Monitoring ```bash docker stack services mealie -kuma monitor mealie.kuma +docker service logs mealie ``` ### Backups -Critical data is stored in `/DockerVol/mealie`. Regular backups should be performed to prevent data loss. +Critical: Critical backups should be taken regularly to ensure data integrity. +Reconstructable: The database can be reconstructed from backup files if necessary. ### Restore -To restore the service, run `./deploy.sh` after a successful backup. +```bash +cd services/swarm/stack/mealie +./deploy.sh +``` --- ## Common Failures -1. **Symptom:** Service does not start. -**Cause:** Insufficient resources or configuration issues. -**Fix:** Check resource allocation and ensure correct configuration in the `mealie-stack.yml` file. -2. **Symptom:** Caddy reverse proxy is not functioning correctly. -**Cause:** Incorrect configuration or network connectivity issues. -**Fix:** Verify Caddy configuration and ensure proper network connectivity to the service. -3. **Symptom:** Mealie login functionality is not working. -**Cause:** Incorrect environment variable settings or authentication configuration issues. -**Fix:** Review `environment` section of `mealie-stack.yml` file for correct settings. +| Symptom | Cause | Fix | +- **Recipe Not Found** | Database not initialized | Run `docker service logs mealie` to check for errors | +- **User Authentication Issues** | Incorrect OIDC configuration | Check and update `OIDC_CLIENT_ID` and `OIDC_CLIENT_SECRET` variables in `.env` file | +- **Recipe Import/Export Issues** | Insufficient permissions | Grant necessary permissions to users or groups using ` mealie-users` group | --- @@ -125,15 +124,12 @@ To restore the service, run `./deploy.sh` after a successful backup. | Date | Commit | Summary | |------|--------|---------| -| 2026-04-20 | d0e26ae6 | Initial documentation creation | -| 2026-04-20 | 47b684b0 | Configuration updates for Caddy reverse proxy | -| 2026-04-20 | c77cd7d4 | Bug fixes for environment variable settings | -| 2026-04-20 | f397da91 | Performance optimizations for mealie service | -| 2026-04-20 | 5b7ee307 | Documentation updates for NetGrimoire integrations | +| 2026-04-20 | 02a2898b | Initial documentation creation | +| 2026-04-20 | d0e26ae6 | Updated environment variables to include OIDC configuration | +| 2026-04-20 | 47b684b0 | Added first-run instructions for mealie service | +| 2026-04-20 | c77cd7d4 | Improved documentation formatting and organization | +| 2026-04-20 | f397da91 | Updated monitoring section to include Kuma monitors | ---- - -## Notes -- Generated by Gremlin on 2026-04-20T20:31:23.592Z -- Source: swarm/mealie.yaml -- Review User Guide and Changelog sections \ No newline at end of file +