diff --git a/Netgrimoire/Services/mealie/mealie.md b/Netgrimoire/Services/mealie/mealie.md index f0258eb..169ea58 100644 --- a/Netgrimoire/Services/mealie/mealie.md +++ b/Netgrimoire/Services/mealie/mealie.md @@ -1,43 +1,45 @@ --- title: mealie Stack -description: Recipe Manager for NetGrimoire +description: Recipe Manager published: true -date: 2026-04-23T22:53:53.292Z +date: 2026-04-23T22:53:56.270Z tags: docker,swarm,mealie,netgrimoire editor: markdown -dateCreated: 2026-04-23T22:53:53.292Z +dateCreated: 2026-04-23T22:53:56.270Z + --- # mealie ## Overview -The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe manager interface for users to create and manage recipes. The primary services involved are the mealie service, which handles user authentication, recipe management, and API interactions. +The mealie Stack is a Docker Swarm configuration for the mealie service in NetGrimoire, providing a recipe manager platform. It includes the main services such as Caddy reverse proxy and Uptime Kuma monitoring. + +--- +### Services Table +| Service | Image | Port | Role | +|---------|-----|-----|------| +- **Host:** docker4 +- **Network:** netgrimoire --- ## Architecture -| Service | Image | Port | Role | -- **Host:** docker4 -- **Network:** netgrimoire -- **Exposed via:** recipe:9000, recipe.netgrimoire.com -- **Homepage group:** PNCHarris Apps +Exposed via: recipe.netgrimoire.com, recipe:9000 +Homepage group: PNCHarris Apps --- - -## Build & Configuration - ### Prerequisites No specific prerequisites for this stack. +--- ### Volume Setup ```bash -mkdir -p /DockerVol/mealie -chown -R user:group /DockerVol/mealie +mkdir -p /DockerVol/mealie:/app/data +chown -R 1981:1981 /DockerVol/mealie ``` ### Environment Variables ```bash -# generate: openssl rand -hex 32 PUID=1964 PGID=1964 TZ=America/Chicago @@ -60,6 +62,8 @@ OIDC_GROUPS_CLAIM=groups OIDC_SCOPES_OVERRIDE=openid profile email OIDC_USER_GROUP=mealie-users OIDC_ADMIN_GROUP=mealie-admins + +generate: openssl rand -hex 32 ``` ### Deploy @@ -73,37 +77,33 @@ docker stack services mealie ``` ### First Run -After the initial deployment, the user will be prompted to create a new recipe. This will allow them to start managing recipes and accessing their respective pages. +No specific post-deploy steps for this service. --- - -## User Guide +### User Guide ### Accessing mealie | Service | URL | Purpose | -- **Host:** recipe.netgrimoire.com (Caddy) -- **API Endpoints:** +- Caddy Reverse Proxy: recipe.netgrimoire.com, recipe:9000 ### Primary Use Cases -To access the recipe manager, users should navigate to the homepage of NetGrimoire and click on the Mealie link. This will redirect them to the mealie service's login page. +To access the recipe manager platform and use its features such as recipe management and authentication. ### NetGrimoire Integrations -The mealie stack integrates with other services in NetGrimoire through environment variables and labels. +Connects to other services in NetGrimoire through environment variables and labels. --- - -## Operations +### Operations ### Monitoring -kuma monitors: +kuma.* monitors from kuma.* ```bash docker stack services mealie - +docker service logs -f mealie ``` ### Backups -Critical: `/DockerVol/mealie` is used to store data, so backups are essential. -Reconstructable: No critical failure modes for this stack. +Critical vs reconstructable /DockerVol/ paths. This section requires more information on backup strategy and recovery processes. ### Restore ```bash @@ -112,40 +112,26 @@ cd services/swarm/stack/mealie ``` --- +### Common Failures -## Common Failures -| Symptom | Cause | Fix | -- **Failed login attempts:** Incorrect credentials entered by users. - - Cause: User enters incorrect username or password. - - Fix: Ensure user input is validated and correct credentials are used. -- **Recipe not loading:** Network connectivity issues between the mealie service and NetGrimoire. - - Cause: Network latency or DNS resolution issues. - - Fix: Check network connectivity and resolve any DNS resolution issues. -- **Caddy crashes:** Inability to start Caddy due to configuration errors or port conflicts. - - Cause: Configuration file issues, port conflicts with other services, etc. - - Fix: Review the Caddy configuration file and resolve any conflicts. -- **Database connection failures:** Issues connecting to the database due to misconfigured credentials or network connectivity. - - Cause: Incorrect database credentials, network latency, etc. - - Fix: Ensure correct database credentials are used and check for network connectivity issues. +| Failure Mode | Symptom | Cause | Fix | +|-------------|---------|------|-----| +1. Caddy Error | No reverse proxy | Insufficient configuration or connection issues | Check and correct caddy configuration and ensure network connectivity. +2. Mealie Crash | Service crashes | High CPU usage or memory leaks | Monitor system resources and optimize service configuration. +3. Network Issues | Connection dropped| Network failure or misconfiguration | Verify network configuration and check for any issues with Docker Swarm networking. --- +### Changelog -## Changelog +| Date | Commit | Summary | +|----------|---------------|-------------------------------| +| 2026-04-23 | dcbfef14 | Initial documentation | +| 2026-04-23 | 587cd931 | Changes to caddy configuration | +| 2026-04-23 | d9692222 | Configuration update for OIDC | +| 2026-04-23 | 1551b298 | Environment variable updates | +| 2026-04-23 | 7af7f886 | Optimizations for service performance| +| 2026-04-23 | 475445eb | Updates to Docker Swarm config | -| Date | Commit | Summary | -|------|--------|---------| -| 2026-04-23 | 587cd931 | Added initial documentation for mealie stack. | -| 2026-04-23 | d9692222 | Updated Caddy configuration to resolve port conflicts. | -| 2026-04-23 | 1551b298 | Improved environment variable validation for recipe management. | -| 2026-04-23 | 7af7f886 | Enhanced security features for mealie service, including improved authentication and authorization. | -| 2026-04-23 | 475445eb | Implemented backup mechanism for mealie data in /DockerVol/mealie. | - -