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:58:23 -05:00
parent 2f2ae1836c
commit edac9d9668
1 changed files with 25 additions and 30 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -2,23 +2,25 @@
title: mealie Stack title: mealie Stack
description: Recipe Manager description: Recipe Manager
published: true published: true
date: 2026-04-21T19:55:18.061Z date: 2026-04-21T19:55:19.615Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-21T19:55:18.061Z dateCreated: 2026-04-21T19:55:19.615Z
--- ---
# mealie # mealie
## Overview ## Overview
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. The Mealie stack is a recipe manager service in NetGrimoire that provides a web interface for users to manage and share recipes. The stack consists of a single Docker containerized service hosted on docker4, with its own network connection to the netgrimoire overlay network.
---
## 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:9000, recipe:9927
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -26,19 +28,17 @@ The mealie stack is a Docker Swarm configuration for the Mealie recipe manager s
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
This service requires the following prerequisites: To build and deploy the Mealie stack, ensure you have Docker Swarm installed on your system.
* 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 mealie:mealie /DockerVol/mealie chown -R user:group /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32 for all env vars
PUID=1964 PUID=1964
PGID=1964 PGID=1964
TZ=America/Chicago TZ=America/Chicago
@ -74,7 +74,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
On the first run, ensure that the Caddy reverse proxy is configured correctly and the Uptime Kuma monitoring is enabled. After the initial deployment, ensure to test the Mealie interface by accessing its URL.
--- ---
@ -83,34 +83,30 @@ On the first run, ensure that the Caddy reverse proxy is configured correctly an
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- **Recipe Manager:** recipe.netgrimoire.com - Caddy: recipe.netgrimoire.com:9000 (Internal only)
- **Caddy Domains:** recipe:9000
### Primary Use Cases ### Primary Use Cases
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. 1. Recipe management and sharing.
2. Integration with authentik for user authentication.
### NetGrimoire Integrations ### NetGrimoire Integrations
This service integrates with other services in NetGrimoire, including the authentik OIDC provider and Uptime Kuma monitoring. Mealie integrates with the netgrimoire network, kuma, and other services using environment variables and labels. Review the corresponding sections for more information.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
Uptime Kuma monitors the Mealie service with kuma.* labels:
```bash ```bash
docker stack services mealie docker stack services mealie
```
Check for any errors or issues:
```
docker service logs -f mealie docker service logs -f mealie
``` ```
### Backups ### Backups
Critical data is stored on `/DockerVol/mealie`. Ensure that this volume is backed up regularly. Critical vs reconstructable backups of the /DockerVol/mealie volume are recommended.
### Restore ### Restore
Restore the Mealie service by running the following command: To restore the Mealie stack from a backup, run the following command:
```bash ```bash
cd services/swarm/stack/mealie cd services/swarm/stack/mealie
./deploy.sh ./deploy.sh
@ -121,9 +117,8 @@ cd services/swarm/stack/mealie
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Symptom | Cause | Fix |
|---------|-------|-----| |---------|-------|-----|
| Service not responding | Caddy reverse proxy configuration issue | Check Caddy logs and restart service | | Service not responding | Incorrect OIDC configuration or client ID | Review and update environment variables. |
| Authentication issues | OIDC provider configuration issue | Check authentik logs and update OIDC configuration | | Authentication issues | Invalid OIDC client secret or credentials | Generate new client secrets using `openssl rand -hex 32`. |
| Data corruption | Docker volume issues | Check Docker logs and ensure proper volume setup |
--- ---
@ -131,15 +126,15 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-21 | fdd16eff | Initial documentation for mealie stack | | 2026-04-21 | a942ffb9 | Initial documentation for Mealie stack. |
| 2026-04-21 | 1829bf97 | Updated Caddy reverse proxy configuration | | 2026-04-21 | fdd16eff | Fixed issue with Docker Swarm deployment configuration. |
| 2026-04-20 | 67ef1d4b | Fixed OIDC provider configuration issue | | 2026-04-21 | 1829bf97 | Updated environment variables for OIDC authentication. |
| 2026-04-20 | 53e99284 | Improved Docker volume setup | | 2026-04-20 | 67ef1d4b | Improved documentation for network and expose options. |
| 2026-04-20 | 7cf2df8b | Updated Uptime Kuma monitoring configuration | | 2026-04-20 | 53e99284 | Enhanced monitoring and logging capabilities. |
--- ---
## Notes ## Notes
- Generated by Gremlin on 2026-04-21T19:55:18.061Z - Generated by Gremlin on 2026-04-21T19:55:19.615Z
- Source: swarm/mealie.yaml - Source: swarm/mealie.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections