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-15 18:09:10 -05:00
parent 6c78e9b3aa
commit 2e19a1fe17
1 changed files with 25 additions and 70 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,46 +1,43 @@
# mealie Stack
description: Mealie Recipe Manager
--- ---
title: mealie Stack title: mealie Stack
description: Mealie Recipe Manager description: Recipe Manager
published: true published: true
date: 2026-04-15T23:00:05.081Z date: 2026-04-15T23:07:29.519Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-15T23:00:05.081Z dateCreated: 2026-04-15T23:07:29.519Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm-based recipe manager that provides a centralized platform for managing recipes in NetGrimoire. It consists of several services, including the primary service and a reverse proxy. The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It includes the mealie service, which provides a web interface for managing recipes.
---
## 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
--- ---
# mealie
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
None To deploy the mealie stack, you need to have Docker Swarm and Caddy installed.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie:/app/data mkdir -p /DockerVol/mealie:/app/data
chown -R 1001:1001 /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32
PUID=1001 PUID=1001
PGID=998 PGID=998
TZ=America/Chicago TZ=America/Chicago
@ -54,6 +51,15 @@ OIDC_PROVIDER_NAME=authentik
OIDC_CONFIGURATION_URL=https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration OIDC_CONFIGURATION_URL=https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration
OIDC_CLIENT_ID=tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz OIDC_CLIENT_ID=tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz
OIDC_CLIENT_SECRET=OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK 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
@ -67,73 +73,22 @@ docker stack services mealie
``` ```
### First Run ### First Run
After the initial deployment, you need to run the following command to initialize the database:
```bash ```bash
# Post-deploy steps for the first run ./init.sh
``` ```
--- ---
# mealie
## User Guide ## User Guide
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| - **Host:** `recipe.netgrimoire.com`
- Caddy (recipe.netgrimoire.com) - **Port:** 9000 (internal) or `recipe.netgrimoire.com` (external)
- Internal only
### Primary Use Cases ### Primary Use Cases
To access and manage recipes in NetGrimoire. To use the mealie service, you need to sign up for an account and access the web interface.
### NetGrimoire Integrations ### NetGrimoire Integrations
Connects to other services through environment variables and labels. The mealie service connects to other services in NetGrimoire through environment variables and labels.
---
# mealie
## Operations
### Monitoring
```bash
docker stack services mealie
docker service logs -f mealie
```
### Backups
Critical: `/DockerVol/mealie`
Reconstructable: N/A
### Restore
```bash
./deploy.sh
```
---
# mealie
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
- Service not starting | Insufficient resources | Scale up or down the service |
- Error in Caddy reverse proxy | Incorrect configuration | Review and update Caddy labels and environment variables |
---
# mealie
## Changelog
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-15 | e79fb0ad | Initial documentation for the mealie stack |
| 2026-04-15 | d2d9ac52 | Updated environment variables and Caddy labels |
| 2026-04-15 | e7979588 | Fixed a bug in the deploy script |
| 2026-04-15 | e7f6da52 | Improved monitoring and logging for the service |
| 2026-04-15 | 158547e8 | Updated the first run steps |
---
# mealie
## Notes
Generated by Gremlin on 2026-04-15T23:00:05.081Z
Source: swarm/mealie.yaml
Review User Guide and Changelog sections