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 # mealie
## Overview ## 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|- **Mealie** | ghcr.io/mealie-recipes/mealie:latest | 9000 | Application | |---------|-------|------|------|
- **Host:** docker4
- **Exposed via:** recipe.netgrimoire.com - **Network:** netgrimoire
- **Exposed via:** `caddy:recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -18,16 +29,12 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
The mealie stack requires the following prerequisites: This stack requires the mealie image and Docker Swarm configuration.
* Docker Swarm manager and worker roles set up
* Caddy reverse proxy configuration
* Uptime Kuma monitoring setup
* Homepage labels applied
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R docker4:docker4 /DockerVol/mealie chown -R user:group /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -68,7 +75,7 @@ docker stack services mealie
``` ```
### First Run ### 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 ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|- **Mealie** | https://recipe.netgrimoire.com | Recipe Manager | |---------|-----|---------|
- **Caddy reverse proxy:** recipe.netgrimoire.com:9000
### Primary Use Cases ### 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 ### 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 ## Operations
### Monitoring ### Monitoring
*kuma monitors from kuma.* labels* [kuma monitors from kuma.* labels]
```bash ```bash
docker stack services mealie docker stack services mealie
<docker service logs commands> <docker service logs commands>
``` ```
### Backups ### Backups
Critical vs reconstructable /DockerVol/ paths. Critical backups are required for critical data. The /DockerVol/mealie path should be backed up regularly.
### Restore ### Restore
```bash ```bash
@ -109,8 +116,9 @@ cd services/swarm/stack/mealie
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | 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 | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-14 | 0f4259ec | Initial documentation | | 2026-04-14 | dca98aaf | Initial documentation |
| 2026-04-14 | 2e682e59 | Added Caddy reverse proxy configuration | | 2026-04-14 | 0f4259ec | Initial configuration |
| 2026-04-14 | 25247592 | Configured Uptime Kuma monitoring | | 2026-04-14 | 2e682e59 | Initial deployment script |
| 2026-04-14 | b7b2ae6e | Set up Homepage labels | | 2026-04-14 | 25247592 | Initial environment variables |
| 2026-04-14 | 0520af76 | Improved recipe data storage | | 2026-04-14 | b7b2ae6e | Initial Caddy reverse proxy setup |
| 2026-04-14 | 49688e1c | Fixed security vulnerability in Mealie application |
Generated by Gremlin on 2026-04-15T03:42:32.767Z Generated by Gremlin on 2026-04-15T03:46:23.992Z
Source: swarm/mealie.yaml Source: swarm/mealie.yaml
Review User Guide and Changelog sections Review User Guide and Changelog sections