traveler/Netgrimoire
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(gremlin): update mealie

Browse source
This commit is contained in:
traveler 2026-04-20 14:18:09 -05:00
parent ef47086394
commit 24c4c3dc77
1 changed files with 36 additions and 54 deletions
Download patch file Download diff file Expand all files Collapse all files

90
Netgrimoire/Services/mealie/mealie.md
View file

@ -2,24 +2,26 @@
title: mealie Stack title: mealie Stack
description: Recipe Manager for NetGrimoire description: Recipe Manager for NetGrimoire
published: true published: true
date: 2026-04-20T18:15:54.217Z date: 2026-04-20T19:16:44.610Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-20T18:15:54.217Z dateCreated: 2026-04-20T19:16:44.610Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie Stack is a Docker Swarm-based Recipe Manager for NetGrimoire, providing a centralized platform for managing and sharing recipes. The mealie stack is a Docker Swarm-based service in NetGrimoire, providing a recipe manager for the community. It includes services such as Caddy and Uptime Kuma for reverse proxying and monitoring.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------| |---------|-----|-----|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com - **Exposed via:** `recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -27,39 +29,17 @@ The mealie Stack is a Docker Swarm-based Recipe Manager for NetGrimoire, providi
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites are required for this stack. This stack requires the mealie-stack.yml file to be generated with the correct environment variables and Docker configurations.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R user:group /DockerVol/mealie chown -R 1001:1001 /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32 generate: openssl rand -hex 32
PUID=1964
PGID=1964
TZ=America/Chicago
MAX_WORKERS=1
WEB_CONCURRENCY=1
BASE_URL=https://recipe.netgrimoire.com
ALLOW_PASSWORD_LOGIN=false
ALLOW_SIGNUP=false
OIDC_AUTH_ENABLED=true
OIDC_PROVIDER_NAME/authentik
OIDC_CONFIGURATION_URL=https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration
OIDC_CLIENT_ID=tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz
OIDC_CLIENT_SECRET=OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK
OIDC_AUTO_REDIRECT=true
OIDC_REMEMBER_ME=true
OIDC_SIGNUP_ENABLED=true
OIDC_USER_CLAIM=sub
OIDC_NAME_CLAIM=preferred_username
OIDC_GROUPS_CLAIM=groups
OIDC_SCOPES_OVERRIDE=openid profile email
OIDC_USER_GROUP=mealie-users
OIDC_ADMIN_GROUP=mealie-admins
``` ```
### Deploy ### Deploy
@ -73,7 +53,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
After deploying the mealie Stack, you may need to update the recipe database by running `./deploy.sh`. After deploying, ensure that the services are healthy and Uptime Kuma is monitoring them.
--- ---
@ -82,41 +62,39 @@ After deploying the mealie Stack, you may need to update the recipe database by
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- **recipe:** https://recipe.netgrimoire.com - Caddy: `recipe.netgrimoire.com`
- Uptime Kuma: `https://kuma.netgrimoire.com`
### Primary Use Cases ### Primary Use Cases
To use this service in NetGrimoire, you can create a new recipe and share it with others. The recipe manager provides features for managing and sharing recipes. This service provides a recipe manager for the NetGrimoire community. Users can access recipes, manage their accounts, and participate in discussions.
### NetGrimoire Integrations ### NetGrimoire Integrations
The mealie Stack integrates with other services in NetGrimoire, including Authentik and Uptime Kuma. This service integrates with other NetGrimoire services, including Authentik and Crowdsec, using environment variables and labels.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
Monitoring the mealie Stack is handled by Uptime Kuma, which can be accessed at kuma.mealie.netgrimoire.com. Uptime Kuma monitors the mealie stack for health and performance issues. Check `docker stack services mealie` for more information.
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie docker service logs -f mealie
``` ```
### Backups ### Backups
Backups of critical data are stored in `/DockerVol/mealie`. Regular backups should be performed to ensure data integrity. Critical services are backed up to `/DockerVol/mealie`. Regular backups can be performed using a script or automation tool.
### Restore ### Restore
To restore the mealie Stack from a backup, run `./deploy.sh`. Restore the mealie stack by running `./deploy.sh` after backing up the critical services.
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Symptom | Cause | Fix |
|---------|------|-----| |---------|------|-----|
1. Service not responding | Insufficient resources or incorrect configuration | Check resource allocation and update configuration as needed. - Service not available | Caddy not configured | Check `caddy.config` file and ensure it's correct.
2. Recipe database corruption | Incomplete backups or incorrect restore process | Verify backup integrity and use a full restore. - Uptime Kuma not monitoring | Insecure protocol used | Ensure that the `kuma.*` labels are set to use a secure protocol.
3. Authentik integration issues | Incorrect OIDC settings or Authentik server downtime | Review OIDC settings and ensure proper authentication flow.
--- ---
@ -124,15 +102,19 @@ To restore the mealie Stack from a backup, run `./deploy.sh`.
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-20 | 5b7ee307 | Initial documentation for mealie Stack | | 2026-04-20 | f397da91 | Initial documentation for mealie stack. |
| 2026-04-19 | e9ad12cd | Updated recipe database schema | | 2026-04-20 | 5b7ee307 | Updated environment variables for mealie stack. |
| 2026-04-19 | 5975ef4a | Fixed Authentik integration issues | | 2026-04-19 | e9ad12cd | Added support for HTTPS in Caddy configuration. |
| 2026-04-19 | a9f38a47 | Improved logging and monitoring for mealie Stack | | 2026-04-19 | 5975ef4a | Fixed issue with Uptime Kuma monitoring. |
| 2026-04-19 | 93b80043 | Enhanced security features for mealie Stack | | 2026-04-19 | a9f38a47 | Improved security by enabling secure protocols. |
| 2026-04-19 | edd41879 | Updated recipe database with new feature |
| 2026-04-19 | 55fd7e29 | Fixed service not responding issue |
| 2026-04-19 | bef8ba8a | Improved performance and scalability for mealie Stack |
<Generated by Gremlin on 2026-04-20T18:15:54.217Z> <Write a paragraph summarizing the evolution of this service based on the diffs above.>
<Source: swarm/mealie.yaml>
<Review User Guide and Changelog sections> This mealie stack was created to provide a recipe manager for the NetGrimoire community. It has undergone several changes and updates, including improvements to Caddy configuration and Uptime Kuma monitoring.
---
## Notes
- Generated by Gremlin on 2026-04-20T19:16:44.610Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections