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-21 14:56:57 -05:00
parent 1ab93feff0
commit 2f2ae1836c
1 changed files with 58 additions and 30 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -2,24 +2,23 @@
title: mealie Stack title: mealie Stack
description: Recipe Manager description: Recipe Manager
published: true published: true
date: 2026-04-21T19:36:38.533Z date: 2026-04-21T19:55:18.061Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-21T19:36:38.533Z dateCreated: 2026-04-21T19:55:18.061Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm configuration for the Mealie recipe manager service in NetGrimoire. This service provides a centralized platform for managing recipes and users. The mealie stack is a Docker Swarm configuration for the Mealie recipe manager service in NetGrimoire. This stack provides a secure and scalable environment for users to access and manage their recipes.
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------| |---------|-----|-----|-----|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com` (Caddy reverse proxy) - **Exposed via:** recipe.netgrimoire.com
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -27,19 +26,41 @@ The mealie stack is a Docker Swarm configuration for the Mealie recipe manager s
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites are required for this stack. This service requires the following prerequisites:
* Docker Swarm manager and worker nodes configured
* Caddy reverse proxy setup with labels for domain mapping
* Uptime Kuma monitoring enabled with kuma.* labels
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R 1964:1964 /DockerVol/mealie chown -R mealie:mealie /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32 PUID=1964
OIDC_CLIENT_ID: tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz PGID=1964
OIDC_CLIENT_SECRET: OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK 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
@ -53,7 +74,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
No specific post-deploy steps are required for this service. On the first run, ensure that the Caddy reverse proxy is configured correctly and the Uptime Kuma monitoring is enabled.
--- ---
@ -62,30 +83,34 @@ No specific post-deploy steps are required for this service.
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- **recipe**: `https://recipe.netgrimoire.com` - **Recipe Manager:** recipe.netgrimoire.com
- Primary authentication method: OIDC with Authentik provider. - **Caddy Domains:** recipe:9000
### Primary Use Cases ### Primary Use Cases
This stack provides a centralized platform for managing recipes and users in NetGrimoire. It can be accessed through the Caddy reverse proxy at `recipe.netgrimoire.com`. This service provides a secure and scalable environment for users to access and manage their recipes. Users can create, edit, and delete recipes, as well as manage user permissions and authentication.
### NetGrimoire Integrations ### NetGrimoire Integrations
The mealie service integrates with other services in NetGrimoire, such as Uptime Kuma for monitoring and Diun for enabling. This service integrates with other services in NetGrimoire, including the authentik OIDC provider and Uptime Kuma monitoring.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
[kuma.name: Mealie] Uptime Kuma monitors the Mealie service with kuma.* labels:
```bash ```bash
docker stack services mealie docker stack services mealie
<docker service logs commands> ```
Check for any errors or issues:
```
docker service logs -f mealie
``` ```
### Backups ### Backups
Critical data is stored on the /DockerVol/mealie volume. Make sure to backup this volume regularly to ensure data integrity. Critical data is stored on `/DockerVol/mealie`. Ensure that this volume is backed up regularly.
### Restore ### Restore
Restore the Mealie service by running the following command:
```bash ```bash
cd services/swarm/stack/mealie cd services/swarm/stack/mealie
./deploy.sh ./deploy.sh
@ -96,9 +121,9 @@ cd services/swarm/stack/mealie
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Symptom | Cause | Fix |
|---------|-------|-----| |---------|-------|-----|
- Service not starting | Insufficient CPU resources | Scale service up or increase resource allocation | | Service not responding | Caddy reverse proxy configuration issue | Check Caddy logs and restart service |
- Caddy reverse proxy issues | Caddy configuration errors | Review and update Caddy configuration files | | Authentication issues | OIDC provider configuration issue | Check authentik logs and update OIDC configuration |
- OIDC authentication issues | Invalid client ID or secret | Update OIDC client ID and secret in environment variables | | Data corruption | Docker volume issues | Check Docker logs and ensure proper volume setup |
--- ---
@ -106,12 +131,15 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-21 | 1829bf97 | Initial documentation creation | | 2026-04-21 | fdd16eff | Initial documentation for mealie stack |
| 2026-04-20 | 67ef1d4b | Revised Caddy configuration for improved security | | 2026-04-21 | 1829bf97 | Updated Caddy reverse proxy configuration |
| 2026-04-20 | 53e99284 | Updated OIDC client ID and secret for better security | | 2026-04-20 | 67ef1d4b | Fixed OIDC provider configuration issue |
| 2026-04-20 | 7cf2df8b | Enhanced logging and monitoring for mealie service | | 2026-04-20 | 53e99284 | Improved Docker volume setup |
| 2026-04-20 | 02a2898b | Fixed critical bug in Caddy reverse proxy configuration | | 2026-04-20 | 7cf2df8b | Updated Uptime Kuma monitoring configuration |
<Generated by Gremlin on 2026-04-21T19:36:38.533Z> ---
<Source: swarm/mealie.yaml>
<Review User Guide and Changelog sections> ## Notes
- Generated by Gremlin on 2026-04-21T19:55:18.061Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections