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-14 22:48:23 -05:00
parent b5b3838c2f
commit 2ace1fd94c
1 changed files with 34 additions and 27 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,16 +1,27 @@
---
title: mealie Stack
description: Mealie Recipe Manager for NetGrimoire
published: true
date: 2026-04-15T03:46:23.992Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-15T03:46:23.992Z
---
# mealie
## Overview
The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe manager for managing recipes. It consists of the Mealie application, which handles recipe management tasks.
The mealie Stack is a Docker Swarm-based service for the Recipe Manager component in NetGrimoire. It provides a centralized platform for recipe management, featuring user authentication, group management, and recipe storage.
---
## Architecture
| Service | Image | Port | Role |
|- **Mealie** | ghcr.io/mealie-recipes/mealie:latest | 9000 | Application |
- **Exposed via:** recipe.netgrimoire.com
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** `caddy:recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps
---
@ -18,16 +29,12 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a
## Build & Configuration
### Prerequisites
The mealie stack requires the following prerequisites:
* Docker Swarm manager and worker roles set up
* Caddy reverse proxy configuration
* Uptime Kuma monitoring setup
* Homepage labels applied
This stack requires the mealie image and Docker Swarm configuration.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R docker4:docker4 /DockerVol/mealie
chown -R user:group /DockerVol/mealie
```
### Environment Variables
@ -68,7 +75,7 @@ docker stack services mealie
```
### First Run
Perform any necessary post-deploy steps, such as initializing database or setting up initial data.
This service does not require a specific first-run process.
---
@ -76,28 +83,28 @@ Perform any necessary post-deploy steps, such as initializing database or settin
### Accessing mealie
| Service | URL | Purpose |
|- **Mealie** | https://recipe.netgrimoire.com | Recipe Manager |
|---------|-----|---------|
- **Caddy reverse proxy:** recipe.netgrimoire.com:9000
### Primary Use Cases
Configure Mealie to manage recipes for specific use cases, such as user authentication and recipe categorization.
Use the Recipe Manager to manage recipes, user authentication, and group management in NetGrimoire.
### NetGrimoire Integrations
Connect Mealie to other services in NetGrimoire, such as authentik or crowdsec, to enable integrations like OAuth authentication and security scanning.
This service integrates with other services through environment variables and Docker Swarm labels.
---
## Operations
### Monitoring
*kuma monitors from kuma.* labels*
[kuma monitors from kuma.* labels]
```bash
docker stack services mealie
<docker service logs commands>
```
### Backups
Critical vs reconstructable /DockerVol/ paths.
Critical backups are required for critical data. The /DockerVol/mealie path should be backed up regularly.
### Restore
```bash
@ -109,8 +116,9 @@ cd services/swarm/stack/mealie
## Common Failures
| Symptom | Cause | Fix |
|- **Mealie crashes with 500 error** | Insufficient resources on worker node | Increase worker resources or scale up worker nodes |
|- **Recipe data lost after update** | Missing backups | Regularly run backups and restore from backup in case of failure |
|---------|-------|-----|
- Mealie not accessible | Incorrect Caddy configuration | Check Caddy labels and verify the reverse proxy is correct.
- Recipe management issues | Environment variables not set correctly | Verify environment variables are set correctly in the .env file.
---
@ -118,13 +126,12 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-14 | 0f4259ec | Initial documentation |
| 2026-04-14 | 2e682e59 | Added Caddy reverse proxy configuration |
| 2026-04-14 | 25247592 | Configured Uptime Kuma monitoring |
| 2026-04-14 | b7b2ae6e | Set up Homepage labels |
| 2026-04-14 | 0520af76 | Improved recipe data storage |
| 2026-04-14 | 49688e1c | Fixed security vulnerability in Mealie application |
| 2026-04-14 | dca98aaf | Initial documentation |
| 2026-04-14 | 0f4259ec | Initial configuration |
| 2026-04-14 | 2e682e59 | Initial deployment script |
| 2026-04-14 | 25247592 | Initial environment variables |
| 2026-04-14 | b7b2ae6e | Initial Caddy reverse proxy setup |
Generated by Gremlin on 2026-04-15T03:42:32.767Z
Generated by Gremlin on 2026-04-15T03:46:23.992Z
Source: swarm/mealie.yaml
Review User Guide and Changelog sections