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
description: Recipe Manager
published: true
date: 2026-04-21T19:55:18.061Z
date: 2026-04-21T19:55:19.615Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-21T19:55:18.061Z
dateCreated: 2026-04-21T19:55:19.615Z
---
# mealie
## 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
| Service | Image | Port | Role |
|---------|-----|-----|-----|
|---------|-----|-----|---------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com
- **Exposed via:** recipe.netgrimoire.com:9000, recipe:9927
- **Homepage group:** PNCHarris Apps
---
@ -26,19 +28,17 @@ The mealie stack is a Docker Swarm configuration for the Mealie recipe manager s
## Build & Configuration
### Prerequisites
This service requires the following prerequisites:
* Docker Swarm manager and worker nodes configured
* Caddy reverse proxy setup with labels for domain mapping
* Uptime Kuma monitoring enabled with kuma.* labels
To build and deploy the Mealie stack, ensure you have Docker Swarm installed on your system.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie
chown -R user:group /DockerVol/mealie
```
### Environment Variables
```bash
# generate: openssl rand -hex 32 for all env vars
PUID=1964
PGID=1964
TZ=America/Chicago
@ -74,7 +74,7 @@ docker stack services mealie
```
### 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
| Service | URL | Purpose |
|---------|-----|---------|
- **Recipe Manager:** recipe.netgrimoire.com
- **Caddy Domains:** recipe:9000
- Caddy: recipe.netgrimoire.com:9000 (Internal only)
### 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
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
### Monitoring
Uptime Kuma monitors the Mealie service with kuma.* labels:
```bash
docker stack services mealie
```
Check for any errors or issues:
```
docker service logs -f mealie
```
### 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 the Mealie service by running the following command:
To restore the Mealie stack from a backup, run the following command:
```bash
cd services/swarm/stack/mealie
./deploy.sh
@ -121,9 +117,8 @@ cd services/swarm/stack/mealie
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
| Service not responding | Caddy reverse proxy configuration issue | Check Caddy logs and restart service |
| Authentication issues | OIDC provider configuration issue | Check authentik logs and update OIDC configuration |
| Data corruption | Docker volume issues | Check Docker logs and ensure proper volume setup |
| Service not responding | Incorrect OIDC configuration or client ID | Review and update environment variables. |
| Authentication issues | Invalid OIDC client secret or credentials | Generate new client secrets using `openssl rand -hex 32`. |
---
@ -131,15 +126,15 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-21 | fdd16eff | Initial documentation for mealie stack |
| 2026-04-21 | 1829bf97 | Updated Caddy reverse proxy configuration |
| 2026-04-20 | 67ef1d4b | Fixed OIDC provider configuration issue |
| 2026-04-20 | 53e99284 | Improved Docker volume setup |
| 2026-04-20 | 7cf2df8b | Updated Uptime Kuma monitoring configuration |
| 2026-04-21 | a942ffb9 | Initial documentation for Mealie stack. |
| 2026-04-21 | fdd16eff | Fixed issue with Docker Swarm deployment configuration. |
| 2026-04-21 | 1829bf97 | Updated environment variables for OIDC authentication. |
| 2026-04-20 | 67ef1d4b | Improved documentation for network and expose options. |
| 2026-04-20 | 53e99284 | Enhanced monitoring and logging capabilities. |
---
## 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
- Review User Guide and Changelog sections