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:38:04 -05:00
parent 55d2638054
commit 1ab93feff0
1 changed files with 34 additions and 53 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,26 +1,25 @@
---
title: mealie Stack
description: Recipe Manager for NetGrimoire
description: Recipe Manager
published: true
date: 2026-04-21T04:19:56.982Z
date: 2026-04-21T19:36:38.533Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-21T04:19:56.982Z
dateCreated: 2026-04-21T19:36:38.533Z
---
# mealie
## Overview
The mealie stack provides a Recipe Manager service for NetGrimoire, allowing users to manage and share recipes.
---
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.
## Architecture
| Service | Image | Port | Role |
|---------|-----|-----|-----|
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com`
- **Exposed via:** `recipe.netgrimoire.com` (Caddy reverse proxy)
- **Homepage group:** PNCHarris Apps
---
@ -28,39 +27,19 @@ The mealie stack provides a Recipe Manager service for NetGrimoire, allowing use
## Build & Configuration
### Prerequisites
To build and deploy the mealie stack, ensure you have the required Docker Swarm configuration file (`mealie-stack.yml`) in place.
No specific prerequisites are required for this stack.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R 1001:1001 /DockerVol/mealie
chown -R 1964:1964 /DockerVol/mealie
```
### Environment Variables
```bash
# 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
OIDC_CLIENT_ID: tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz
OIDC_CLIENT_SECRET: OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK
```
### Deploy
@ -74,7 +53,7 @@ docker stack services mealie
```
### First Run
After deployment, ensure the mealie service is accessible and the necessary integrations are configured.
No specific post-deploy steps are required for this service.
---
@ -83,40 +62,43 @@ After deployment, ensure the mealie service is accessible and the necessary inte
### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
- **Host:** `recipe.netgrimoire.com`
- **Purpose:** Accessing the Recipe Manager interface
- **recipe**: `https://recipe.netgrimoire.com`
- Primary authentication method: OIDC with Authentik provider.
### Primary Use Cases
* Manage recipes and their respective tags.
* Share recipes with other users in NetGrimoire.
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`.
### NetGrimoire Integrations
* The mealie service integrates with other services, such as the Uptime Kuma monitoring system, to provide a comprehensive view of the recipe management capabilities.
The mealie service integrates with other services in NetGrimoire, such as Uptime Kuma for monitoring and Diun for enabling.
---
## Operations
### Monitoring
Use kuma monitors from kuma.* labels to track the performance and availability of the mealie service.
[kuma.name: Mealie]
```bash
docker stack services mealie
docker service logs -f mealie
<docker service logs commands>
```
### Backups
Critical vs reconstructable /DockerVol/ paths require careful management to ensure data integrity.
Critical data is stored on the /DockerVol/mealie volume. Make sure to backup this volume regularly to ensure data integrity.
### Restore
Restore the mealie service by running `./deploy.sh`.
```bash
cd services/swarm/stack/mealie
./deploy.sh
```
---
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
* Service not accessible | Insufficient resources on node | Increase instance size or add more nodes |
* Recipe data loss | Incomplete backup process | Review backup logs and adjust settings as needed |
- Service not starting | Insufficient CPU resources | Scale service up or increase resource allocation |
- Caddy reverse proxy issues | Caddy configuration errors | Review and update Caddy configuration files |
- OIDC authentication issues | Invalid client ID or secret | Update OIDC client ID and secret in environment variables |
---
@ -124,13 +106,12 @@ Restore the mealie service by running `./deploy.sh`.
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-20 | 67ef1d4b | Initial documentation creation |
| 2026-04-20 | 53e99284 | Added support for Uptime Kuma monitoring |
| 2026-04-20 | 7cf2df8b | Improved environment variable handling |
| 2026-04-20 | 02a2898b | Enhanced logging and error handling |
| 2026-04-20 | d0e26ae6 | Fixed issues with recipe data import |
| 2026-04-20 | 47b684b0 | Updated documentation to reflect new feature set |
| 2026-04-21 | 1829bf97 | Initial documentation creation |
| 2026-04-20 | 67ef1d4b | Revised Caddy configuration for improved security |
| 2026-04-20 | 53e99284 | Updated OIDC client ID and secret for better security |
| 2026-04-20 | 7cf2df8b | Enhanced logging and monitoring for mealie service |
| 2026-04-20 | 02a2898b | Fixed critical bug in Caddy reverse proxy configuration |
Generated by Gremlin on 2026-04-21T04:19:56.982Z
Source: swarm/mealie.yaml
Review User Guide and Changelog sections
<Generated by Gremlin on 2026-04-21T19:36:38.533Z>
<Source: swarm/mealie.yaml>
<Review User Guide and Changelog sections>