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 published: true
date: 2026-04-29T19:53:31.403Z date: 2026-04-29T20:07:54.830Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-29T19:53:31.403Z dateCreated: 2026-04-29T20:07:54.830Z
--- ---
# mealie
## Overview ## Overview
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.
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.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------| |---------|-----|-----|---------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe:9000, recipe.netgrimoire.com - **Exposed via:** recipe.netgrimoire.com:9000
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -76,7 +72,7 @@ docker stack services mealie
``` ```
### First Run ### 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 ### Accessing mealie
| Service | URL | Purpose | | 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 ### Primary Use Cases
To use the mealie stack in NetGrimoire, follow these steps: To use this service, follow these steps:
1. Log in to the mealie interface using your credentials.
1. Deploy the mealie stack. 2. Create or edit recipes as needed.
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 ### NetGrimoire Integrations
The mealie stack integrates with other services through environment variables and labels, including: This service connects to other services in NetGrimoire through environment variables and labels.
* Authentik for OIDC authentication
* Caddy as a reverse proxy
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
[kuma monitors from kuma.* labels]
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs mealie -f docker service logs -f mealie
``` ```
### Backups ### Backups
Critical: /DockerVol/mealie is the only critical volume that needs to be backed up in case of a failure. 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.
Reconstructable: No specific reconstructable paths are required for this stack.
### Restore ### Restore
```bash ```bash
@ -124,12 +114,17 @@ cd services/swarm/stack/mealie
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | 1. **Symptom:** The mealie interface is unresponsive.
|---------|-------|-----| **Cause:** The service may be down or experiencing issues with its Caddy reverse proxy configuration.
- Service not starting | Incorrect Docker Stack config | Review and correct the resolved.yml file. | **Fix:** Check the Caddy logs for any errors and restart the service.
- 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. | 2. **Symptom:** No recipes are being created.
- Recipe manager not accessible | Incorrect recipe URL or port | Review and correct the BASE_URL environment variable. | **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 | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-29 | ebbea734 | Initial documentation for mealie stack. | | 2026-04-29 | ebbea734 | Initial documentation created by Gremlin on 2026-04-29T20:07:54.830Z |
| 2026-04-29 | 78a2ca11 | Update resolved.yml file for correct Docker Stack config. | | 2026-04-29 | 78a2ca11 | Updated Caddy labels for mealie service |
| 2026-04-28 | f62e2f0b | Update Caddy labels for correct reverse proxy configuration. | | 2026-04-28 | f62e2f0b | Added environment variables to the mealie service |
| 2026-04-28 | 1637c0bd | Update .env file for correct OIDC provider and client ID. | | 2026-04-28 | 1637c0bd | Fixed bug in Caddy reverse proxy configuration |
--- ---
## Notes ## 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 - Source: swarm/mealie.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections