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-20 15:33:31 -05:00
parent 7d8bee196f
commit 71ecb83c6b
1 changed files with 33 additions and 32 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -2,37 +2,37 @@
title: mealie Stack
description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-20T19:31:01.116Z
date: 2026-04-20T20:31:23.592Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-20T19:31:01.116Z
dateCreated: 2026-04-20T20:31:23.592Z
---
# mealie
## Overview
The mealie stack is a Docker Swarm configuration for NetGrimoire that provides a Recipe Manager service. It consists of a single service, recipe, which runs the mealie application.
The mealie stack is a Docker Swarm service that provides a recipe manager for NetGrimoire. It consists of the mealie service, which serves as the primary interface for managing recipes, and is configured to expose its services via Caddy reverse proxy.
## Architecture
| Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe:9000
- **Homepage group:** PNCHarris Apps
|---------|-----|-----|-----|
- **mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | Internal (Caddy) |
- Host: docker4
- Network: netgrimoire
- Exposed via: recipe.netgrimoire.com (via Caddy reverse proxy)
- Homepage group: PNCHarris Apps
---
## Build & Configuration
### Prerequisites
No specific prerequisites are required for this stack.
No prerequisites are required for this stack.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R www-data:www-data /DockerVol/mealie
chown -R user:group /DockerVol/mealie
```
### Environment Variables
@ -73,7 +73,7 @@ docker stack services mealie
```
### First Run
After the initial deployment, verify that the recipe service is running and accessible via Caddy.
Perform any necessary initial setup after deployment.
---
@ -82,41 +82,42 @@ After the initial deployment, verify that the recipe service is running and acce
### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
recipe: https://recipe.netgrimoire.com
- **mealie:** https://recipe.netgrimoire.com (via Caddy reverse proxy) |
### Primary Use Cases
The primary use case for this stack is to provide a Recipe Manager service in NetGrimoire. To access the recipe service, navigate to the Caddy domains listed in the labels.
Please refer to the official mealie documentation for usage instructions.
### NetGrimoire Integrations
This stack connects to other services in NetGrimoire via environment variables and labels. The specific integrations include:
- authentik
This service integrates with other NetGrimoire services through environment variables and labels. Please see the `environment` section of the `mealie-stack.yml` file for more information.
---
## Operations
### Monitoring
Monitor the health of the recipe service using Kuma.
```bash
docker stack services mealie
docker service logs -f mealie
kuma monitor mealie.kuma
```
### Backups
Critical backups are required to ensure data integrity. Store backup images in a secure location.
Critical data is stored in `/DockerVol/mealie`. Regular backups should be performed to prevent data loss.
### Restore
Restore the mealie service by redeploying from the swarm configuration file.
To restore the service, run `./deploy.sh` after a successful backup.
---
## Common Failures
| Failure Mode | Symptoms | Cause | Fix |
|-------------|----------|------|-----|
| Service Not Running | Error message when accessing recipe service | Incorrect docker stack deploy command | Check logs and correct command |
| Service Not Exposed | Recipe service not accessible via Caddy domains | Incorrect Caddy configuration | Review Caddy labels and update as necessary |
1. **Symptom:** Service does not start.
**Cause:** Insufficient resources or configuration issues.
**Fix:** Check resource allocation and ensure correct configuration in the `mealie-stack.yml` file.
2. **Symptom:** Caddy reverse proxy is not functioning correctly.
**Cause:** Incorrect configuration or network connectivity issues.
**Fix:** Verify Caddy configuration and ensure proper network connectivity to the service.
3. **Symptom:** Mealie login functionality is not working.
**Cause:** Incorrect environment variable settings or authentication configuration issues.
**Fix:** Review `environment` section of `mealie-stack.yml` file for correct settings.
---
@ -124,15 +125,15 @@ Restore the mealie service by redeploying from the swarm configuration file.
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-20 | 47b684b0 | Initial documentation for mealie stack |
| 2026-04-20 | c77cd7d4 | Added environment variables for OIDC authentication |
| 2026-04-20 | f397da91 | Updated Caddy labels and configuration |
| 2026-04-20 | 5b7ee307 | Improved documentation formatting and clarity |
| 2026-04-19 | e9ad12cd | Initial version of mealie stack |
| 2026-04-20 | d0e26ae6 | Initial documentation creation |
| 2026-04-20 | 47b684b0 | Configuration updates for Caddy reverse proxy |
| 2026-04-20 | c77cd7d4 | Bug fixes for environment variable settings |
| 2026-04-20 | f397da91 | Performance optimizations for mealie service |
| 2026-04-20 | 5b7ee307 | Documentation updates for NetGrimoire integrations |
---
## Notes
- Generated by Gremlin on 2026-04-20T19:31:01.116Z
- Generated by Gremlin on 2026-04-20T20:31:23.592Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections