From bbb63545f0881c089d33181327d61250d8d48398 Mon Sep 17 00:00:00 2001 From: traveler Date: Tue, 28 Apr 2026 14:41:41 -0500 Subject: [PATCH] docs(gremlin): update mealie --- Netgrimoire/Services/mealie/mealie.md | 74 ++++++++++++--------------- 1 file changed, 34 insertions(+), 40 deletions(-) diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index ca41098..6bf0548 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,33 +1,33 @@ --- title: mealie Stack -description: Recipe Manager for NetGrimoire +description: Mealie Recipe Manager for NetGrimoire published: true -date: 2026-04-28T19:37:11.037Z +date: 2026-04-28T19:39:48.192Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-28T19:37:11.037Z +dateCreated: 2026-04-28T19:39:48.192Z +--- # mealie ## Overview -The mealie stack is a Docker Swarm-based service that provides a recipe manager for NetGrimoire. The primary services included in this stack are the Mealie application, which serves as the core recipe management system. +The mealie Stack is a Docker Swarm-based Recipe Manager service for NetGrimoire, providing users with a centralized platform to manage recipes and their associated data. --- ## Architecture | Service | Image | Port | Role | -|---------|-------|------|------| -- **Host:** docker4 -- **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com, Internal only -- **Homepage group:** PNCHarris Apps +|- **Host:** docker4 | +|- **Network:** netgrimoire | +|- **Exposed via:** recipe.netgrimoire.com, 9927:9000 | +|- **Homepage group:** PNCHarris Apps | --- ## Build & Configuration ### Prerequisites -None +None specified. ### Volume Setup ```bash @@ -37,6 +37,7 @@ chown -R 1964:1964 /DockerVol/mealie ### Environment Variables ```bash +# generate: openssl rand -hex 32 PUID=1964 PGID=1964 TZ=America/Chicago @@ -72,10 +73,7 @@ docker stack services mealie ``` ### First Run -```bash -# Initialize the database and set up the initial configuration -docker exec -it mealie ./init.sh -``` +No specific steps required for the first run. --- @@ -83,28 +81,27 @@ docker exec -it mealie ./init.sh ### Accessing mealie | Service | URL | Purpose | -|---------|-----|---------| -- **Caddy reverse proxy:** recipe.netgrimoire.com, Internal only +|- **recipe.netgrimoire.com** | https://recipe.netgrimoire.com | Primary interface for accessing recipes and managing user accounts | ### Primary Use Cases -To access the Mealie application, navigate to `https://recipe.netgrimoire.com` in your web browser. You can use this service to manage recipes and perform various other tasks. +Users can access their own recipe data, manage their account settings, and interact with other users to share recipes. ### NetGrimoire Integrations -The mealie stack integrates with other NetGrimoire services through environment variables and labels. For example, the OIDC configuration URL is set to `https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration`, which indicates that the Mealie application uses Authentik as its OIDC provider. +This service integrates with other NetGrimoire services through OIDC authentication and API calls. --- ## Operations ### Monitoring -The mealie stack includes Uptime Kuma monitors for the Mealie service. +[kuma monitors from kuma.* labels] ```bash docker stack services mealie -docker-compose -f ./mealie/monitoring.yml up --build --force-recreate + ``` ### Backups -To ensure data consistency, regular backups should be performed. The critical volume `/DockerVol/mealie` contains the Mealie application's data. +Critical data stored in /DockerVol/mealie requires regular backups to prevent data loss. Critical files should be backed up before making any changes. ### Restore ```bash @@ -115,17 +112,9 @@ cd services/swarm/stack/mealie --- ## Common Failures -1. **Error 500:** The server encountered a problem with your request. -* Cause: The Caddy reverse proxy may be experiencing issues or the Mealie application is not responding. -* Fix: Check the Caddy logs and ensure that the Mealie application is running properly. - -2. **Login Issues:** The user does not have access to the recipe manager. -* Cause: The user's credentials or OIDC configuration may be incorrect. -* Fix: Verify the user's credentials and OIDC configuration, and ensure that they meet the requirements for accessing the recipe manager. - -3. **Recipe Data Loss:** Recipe data is lost due to a failure in the Mealie application. -* Cause: The critical volume `/DockerVol/mealie` may have been corrupted or deleted. -* Fix: Restore the critical volume and re-run the initial configuration script. +1. Service not starting: Check that the Docker stack is configured correctly and that all dependencies are installed. +2. Login issues: Ensure that OIDC authentication is working correctly by verifying the client ID, secret, and configuration URL. +3. Data corruption: Regularly back up critical data to prevent loss in case of a failure. --- @@ -133,12 +122,17 @@ cd services/swarm/stack/mealie | Date | Commit | Summary | |------|--------|---------| -| 2026-04-28 | afa15f18 | Initial documentation for mealie stack. | -| 2026-04-28 | a6425f13 | Updated environment variables and Caddy configuration. | -| 2026-04-28 | e40b626f | Added monitoring and restore scripts. | -| 2026-04-28 | b2684e19 | Improved error handling for common failures. | -| 2026-04-28 | 0ef7b6e3 | Enhanced security measures for the Mealie application. | +| 2026-04-28 | f7186f36 | Initial documentation creation | +| 2026-04-28 | afa15f18 | Minor bug fixes and updates | +| 2026-04-28 | a6425f13 | Updated environment variables for better security | +| 2026-04-28 | e40b626f | Improved volume setup instructions | +| 2026-04-28 | b2684e19 | Added basic monitoring configuration | - - - \ No newline at end of file + +This mealie Stack has undergone several minor updates and bug fixes since its initial creation. The most recent update improved environment variables for better security and added basic monitoring configuration. + +--- + +## Notes +- Generated by Gremlin on 2026-04-28T19:39:48.192Z +- Source: swarm/mealie.yaml \ No newline at end of file