docs(gremlin): update mealie

This commit is contained in:
traveler 2026-04-19 20:38:34 -05:00
parent 8c2dc43d65
commit 4d819da41a

View file

@ -1,126 +1,15 @@
---
title: mealie Stack
description: Recipe Manager
published: true
date: 2026-04-20T00:57:42.899Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-20T00:57:42.899Z
---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm-based service that provides a recipe management system for NetGrimoire. It includes the Mealie application, which manages recipes and allows users to access and manage them. The mealie stack is a NetGrimoire service that provides a recipe manager with user authentication, authorization, and profile management features.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|-----| |- **Host:** docker4
- **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com, mealie:9000 - **Exposed via:** caddy://recipe.netgrimoire.com, recipe:9000 (Internal only)
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
## Build & Configuration ---
### Prerequisites
No specific prerequisites are required for this stack.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R 1001:1001 /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
```
### Deploy
```bash
cd services/swarm/stack/mealie
set -a && source .env && set +a
docker stack config --compose-file mealie-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml mealie
rm resolved.yml
docker stack services mealie
```
### First Run
No specific steps are required for the first run.
## User Guide
### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
- **Recipe Management:** recipe.netgrimoire.com
- **Login:** Not available (OIDC only)
### Primary Use Cases
Use Mealie to manage recipes and access them.
### NetGrimoire Integrations
Mealie integrates with Authentik for OIDC authentication.
## Operations
### Monitoring
```bash
docker stack services mealie
docker service logs -f mealie
```
### Backups
Critical: No critical data is stored on the Docker volumes. Reconstructable: Volumes are not critical.
### Restore
```bash
cd services/swarm/stack/mealie
./deploy.sh
```
## Common Failures
| Symptom | Cause | Fix |
|---------|------|-----|
- Recipe Management fails | Insufficient OIDC client secrets | Ensure correct client secret and configuration URL |
- Login issues | Incorrect OIDC client credentials | Ensure correct OIDC client ID and client secret |
## Changelog
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-19 | 93b80043 | Initial documentation |
| 2026-04-19 | edd41879 | Updated OIDC configuration URL |
| 2026-04-19 | 55fd7e29 | Fixed recipe management issues |
| 2026-04-19 | bef8ba8a | Improved login functionality |
| 2026-04-19 | 148881ef | Enhanced security measures |
## Notes
- Generated by Gremlin on 2026-04-20T00:57:42.899Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections