docs(gremlin): update mealie
This commit is contained in:
parent
8c2dc43d65
commit
4d819da41a
1 changed files with 6 additions and 117 deletions
|
|
@ -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
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue