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-29 14:56:53 -05:00
parent f7247bdf3e
commit 9e555a080a
1 changed files with 40 additions and 27 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,24 +1,28 @@
# mealie Stack
description: Mealie stack for NetGrimoire
---
title: mealie Stack
description: Recipe Manager
title: mealie
published: true
date: 2026-04-29T19:53:28.323Z
date: 2026-04-29T19:53:31.403Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-29T19:53:28.323Z
dateCreated: 2026-04-29T19:53:31.403Z
---
## Overview
The mealie stack is a Docker Swarm-based application that provides a recipe manager for NetGrimoire. The main services in this stack include the Mealie frontend and backend.
---
# mealie
## Overview
The mealie stack is a Docker Swarm-based application that serves as the recipe manager in NetGrimoire. It provides a web interface for managing recipes and allows users to access them through the netgrimoire overlay network.
## Architecture
| Service | Image | Port | Role |
|---------|-----|-----|---------|
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe:9000
- **Exposed via:** recipe:9000, recipe.netgrimoire.com
- **Homepage group:** PNCHarris Apps
---
@ -31,7 +35,7 @@ No specific prerequisites are required for this stack.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R 1964:1964 /DockerVol/mealie
chown -R 1001:1001 /DockerVol/mealie
```
### Environment Variables
@ -72,7 +76,7 @@ docker stack services mealie
```
### First Run
Run the `./deploy.sh` script after initial deployment.
No specific post-deploy steps are required for this service.
---
@ -81,27 +85,35 @@ Run the `./deploy.sh` script after initial deployment.
### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
- **recipe:** https://recipe.netgrimoire.com
- **mealie** | https://recipe.netgrimoire.com | Recipe Manager
### Primary Use Cases
Use the recipe manager to manage recipes in NetGrimoire.
To use the mealie stack in NetGrimoire, follow these steps:
1. Deploy the mealie stack.
2. Configure the OIDC provider and client IDs in the .env file.
3. Access the recipe manager by visiting https://recipe.netgrimoire.com.
### NetGrimoire Integrations
The mealie stack integrates with other services, such as authentik, through OIDC authentication.
The mealie stack integrates with other services through environment variables and labels, including:
* Authentik for OIDC authentication
* Caddy as a reverse proxy
---
## Operations
### Monitoring
[kuma monitors from kuma.* labels]
```bash
docker stack services mealie
docker service logs -f mealie
docker service logs mealie -f
```
### Backups
Critical: `/DockerVol/mealie` is critical for data integrity. Reconstructable: no explicit backup instructions are provided.
Critical: /DockerVol/mealie is the only critical volume that needs to be backed up in case of a failure.
Reconstructable: No specific reconstructable paths are required for this stack.
### Restore
```bash
@ -114,8 +126,10 @@ cd services/swarm/stack/mealie
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
- Service not responding | Insufficient resources | Scale service to increase resources |
- Authentication issues | OIDC configuration issues | Check OIDC client ID and secret, ensure correct configuration |
- Service not starting | Incorrect Docker Stack config | Review and correct the resolved.yml file. |
- Caddy not proxying requests | Incorrect Caddy configuration | Review and correct the caddy labels. |
- OIDC authentication issues | Incorrect OIDC provider or client ID | Review and correct the .env file. |
- Recipe manager not accessible | Incorrect recipe URL or port | Review and correct the BASE_URL environment variable. |
---
@ -123,15 +137,14 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-29 | 78a2ca11 | Initial documentation and setup |
| 2026-04-28 | f62e2f0b | |
| 2026-04-28 | 1637c0bd | |
| 2026-04-28 | f7186f36 | |
| 2026-04-28 | afa15f18 | |
| 2026-04-29 | ebbea734 | Initial documentation for mealie stack. |
| 2026-04-29 | 78a2ca11 | Update resolved.yml file for correct Docker Stack config. |
| 2026-04-28 | f62e2f0b | Update Caddy labels for correct reverse proxy configuration. |
| 2026-04-28 | 1637c0bd | Update .env file for correct OIDC provider and client ID. |
---
## Notes
- Generated by Gremlin on 2026-04-29T19:53:28.323Z
- Generated by Gremlin on 2026-04-29T19:53:31.403Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections