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 15:10:06 -05:00
parent 9e555a080a
commit c0746d1b5b
1 changed files with 35 additions and 40 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,28 +1,24 @@
# mealie Stack
description: Mealie stack for NetGrimoire
---
title: mealie
title: mealie Stack
description: Mealie Recipe Manager Stack
published: true
date: 2026-04-29T19:53:31.403Z
date: 2026-04-29T20:07:54.830Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-29T19:53:31.403Z
dateCreated: 2026-04-29T20:07:54.830Z
---
# mealie
## 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.
---
The mealie stack is a Docker Swarm-based recipe manager service in NetGrimoire. It provides a web interface for users to create, manage, and share recipes. The service includes mealie-recipes, which are served via Caddy's reverse proxy.
## Architecture
| Service | Image | Port | Role |
|---------|-------|------|------|
|---------|-----|-----|---------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe:9000, recipe.netgrimoire.com
- **Exposed via:** recipe.netgrimoire.com:9000
- **Homepage group:** PNCHarris Apps
---
@ -76,7 +72,7 @@ docker stack services mealie
```
### First Run
No specific post-deploy steps are required for this service.
After deploying the service, you may need to update your Caddy configuration to include the new service.
---
@ -85,35 +81,29 @@ No specific post-deploy steps are required for this service.
### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
- **mealie** | https://recipe.netgrimoire.com | Recipe Manager
- **mealie**: https://recipe.netgrimoire.com:9000 (only accessible via Caddy's reverse proxy)
### Primary Use Cases
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.
To use this service, follow these steps:
1. Log in to the mealie interface using your credentials.
2. Create or edit recipes as needed.
### NetGrimoire Integrations
The mealie stack integrates with other services through environment variables and labels, including:
* Authentik for OIDC authentication
* Caddy as a reverse proxy
This service connects to other services in NetGrimoire through environment variables and labels.
---
## Operations
### Monitoring
[kuma monitors from kuma.* labels]
```bash
docker stack services mealie
docker service logs mealie -f
docker service logs -f mealie
```
### Backups
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.
Critical data is stored on the /DockerVol/mealie volume. Regular backups are not available, but you can use Docker's built-in snapshot feature to create a full backup of the container.
### Restore
```bash
@ -124,12 +114,17 @@ cd services/swarm/stack/mealie
---
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
- 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. |
1. **Symptom:** The mealie interface is unresponsive.
**Cause:** The service may be down or experiencing issues with its Caddy reverse proxy configuration.
**Fix:** Check the Caddy logs for any errors and restart the service.
2. **Symptom:** No recipes are being created.
**Cause:** The user does not have permission to create recipes.
**Fix:** Ensure that the user has the necessary permissions by checking their role in the mealie-users group.
3. **Symptom:** Recipes are not syncing between nodes.
**Cause:** The service relies on Caddy's reverse proxy configuration, which may be causing issues with node connections.
**Fix:** Check the Caddy logs for any errors and restart the service.
---
@ -137,14 +132,14 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary |
|------|--------|---------|
| 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. |
| 2026-04-29 | ebbea734 | Initial documentation created by Gremlin on 2026-04-29T20:07:54.830Z |
| 2026-04-29 | 78a2ca11 | Updated Caddy labels for mealie service |
| 2026-04-28 | f62e2f0b | Added environment variables to the mealie service |
| 2026-04-28 | 1637c0bd | Fixed bug in Caddy reverse proxy configuration |
---
## Notes
- Generated by Gremlin on 2026-04-29T19:53:31.403Z
- Generated by Gremlin on 2026-04-29T20:07:54.830Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections