diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index 172f599..72ceebb 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,26 +1,27 @@ --- + title: mealie Stack description: Recipe Manager for NetGrimoire published: true -date: 2026-04-16T04:22:33.760Z +date: 2026-04-16T05:12:34.909Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-16T04:22:33.760Z +dateCreated: 2026-04-16T05:12:34.909Z --- # mealie ## Overview -The mealie stack is a Docker Swarm-based service that provides a recipe manager for NetGrimoire. It includes the Mealie application, which allows users to create and manage recipes. +The mealie stack is a Recipe Manager service for NetGrimoire. It provides features such as recipe listing and management. --- ## Architecture | Service | Image | Port | Role | -|---------|-----|-----|-----| +|---------|-----|-----|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** recipe.netgrimoire.com +- **Exposed via:** `recipe.netgrimoire.com` - **Homepage group:** PNCHarris Apps --- @@ -28,12 +29,12 @@ The mealie stack is a Docker Swarm-based service that provides a recipe manager ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +Ensure that the necessary Docker Swarm and environment variables are set. ### Volume Setup ```bash mkdir -p /DockerVol/mealie -chown -R docker:docker /DockerVol/mealie +chown -R 1001:1001 /DockerVol/mealie ``` ### Environment Variables @@ -74,7 +75,7 @@ docker stack services mealie ``` ### First Run -No specific post-deploy steps are required for this service. +After the initial deployment, verify that the service is accessible and running. --- @@ -83,13 +84,13 @@ No specific post-deploy steps are required for this service. ### Accessing mealie | Service | URL | Purpose | |---------|-----|---------| -- **mealie**: recipe.netgrimoire.com (Primary) / +- **Recipe Manager** | `recipe.netgrimoire.com` | Access recipes and management interface ### Primary Use Cases -To use the Mealie application, navigate to the primary URL. Users can create and manage recipes, as well as access their profile information. +Use this service to manage recipes in NetGrimoire. ### NetGrimoire Integrations -This service connects to other services in NetGrimoire through environment variables and labels, such as Authentik for authentication. +This service integrates with authentik for OAuth authentication. --- @@ -98,27 +99,25 @@ This service connects to other services in NetGrimoire through environment varia ### Monitoring ```bash docker stack services mealie -docker service logs -f mealie +docker service logs mealie -f ``` ### Backups -Critical data is stored on the host machine. Regular backups are not necessary. +Critical: `/DockerVol/mealie` and reconstructable ### Restore -No specific restore process is required for this service. +```bash +cd services/swarm/stack/mealie +./deploy.sh +``` --- ## Common Failures -1. **Symptom:** Mealie application fails to start. -**Cause:** Insufficient resources or network connectivity issues. -**Fix:** Ensure sufficient resources and verify network connectivity. -2. **Symptom:** Authentication fails with Authentik. -**Cause:** Incorrect credentials or invalid configuration. -**Fix:** Verify authentication credentials and reconfigure Authentik settings as necessary. -3. **Symptom:** Mealie application crashes due to insufficient memory. -**Cause:** High load or resource-intensive operations. -**Fix:** Optimize resource usage and implement caching mechanisms to reduce load. +| Failure Mode | Symptoms | Cause | Fix | +|-------------|----------|------|-----| +- Inaccessible service | Service not responding | Incorrect environment variables or configuration issues | Check and correct environment variables and ensure proper Docker Swarm setup. | +- Unauthorized access | Unable to log in with credentials | Incorrect authentication settings | Review and update the OAuth configuration and client IDs. | --- @@ -126,15 +125,14 @@ No specific restore process is required for this service. | Date | Commit | Summary | |------|--------|---------| -| 2026-04-15 | e1f9ff52 | Initial deployment | -| 2026-04-15 | cee5a6c1 | Fixed minor bug in authentication configuration | -| 2026-04-15 | 589d1cb0 | Updated version of Authentik library | -| 2026-04-15 | fc707183 | Improved performance by adding caching mechanisms | -| 2026-04-15 | fc964327 | Resolved issue with recipe data storage | -| 2026-04-15 | 3a30cd8a | Updated environment variables for better security | -| 2026-04-15 | ce9de8f3 | Enhanced user interface for improved usability | -| 2026-04-15 | 1076a1ad | Fixed issue with mealie application startup | +| 2026-04-16 | b46925df | Initial documentation creation | +| 2026-04-15 | e1f9ff52 | Updated environment variables for mealie stack | - - - \ No newline at end of file + + +--- + +## Notes +- Generated by Gremlin on 2026-04-16T05:12:34.909Z +- Source: swarm/mealie.yaml +- Review User Guide and Changelog sections \ No newline at end of file