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:56:31 -05:00
parent 2ace1fd94c
commit 67b32e3c31
1 changed files with 35 additions and 31 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,40 +1,42 @@
--- ---
title: mealie Stack title: mealie Stack
description: Mealie Recipe Manager for NetGrimoire description: Recipe Manager
published: true published: true
date: 2026-04-15T03:46:23.992Z date: 2026-04-15T03:54:25.425Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-15T03:46:23.992Z dateCreated: 2026-04-15T03:54:25.425Z
--- ---
# mealie # mealie
## Overview ## Overview
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. The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire. It consists of the mealie service, which provides a web interface for managing recipes.
--- ---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------| |-|-|-|-|
- **Host:** docker4 - **mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | recipe.netgrimoire.com |
- **Network:** netgrimoire
- **Exposed via:** `caddy:recipe.netgrimoire.com` Exposed via:
- **Homepage group:** PNCHarris Apps * caddy domains from labels
Homepage group:
PNCHarris Apps
--- ---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
This stack requires the mealie image and Docker Swarm configuration. Specific prerequisites for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R user:group /DockerVol/mealie chown -R mealie:mealie /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -75,7 +77,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
This service does not require a specific first-run process. Post-deploy steps specific to these services.
--- ---
@ -83,28 +85,28 @@ This service does not require a specific first-run process.
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |-|-|-|
- **Caddy reverse proxy:** recipe.netgrimoire.com:9000 * mealie: recipe.netgrimoire.com |
### Primary Use Cases ### Primary Use Cases
Use the Recipe Manager to manage recipes, user authentication, and group management in NetGrimoire. How to actually use this in NetGrimoire.
### NetGrimoire Integrations ### NetGrimoire Integrations
This service integrates with other services through environment variables and Docker Swarm labels. Which other services this connects to — derive from env vars and 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 backups are required for critical data. The /DockerVol/mealie path should be backed up regularly. Critical vs reconstructable /DockerVol/ paths.
### Restore ### Restore
```bash ```bash
@ -115,10 +117,7 @@ cd services/swarm/stack/mealie
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | 5 specific failure modes with symptom, cause, fix.
|---------|-------|-----|
- 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.
--- ---
@ -126,12 +125,17 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-14 | dca98aaf | Initial documentation | | 2026-04-14 | 082de5d8 | <infer what changed from the diffs above> |
| 2026-04-14 | 0f4259ec | Initial configuration | | 2026-04-14 | dca98aaf | <infer what changed from the diffs above> |
| 2026-04-14 | 2e682e59 | Initial deployment script | | 2026-04-14 | 0f4259ec | <infer what changed from the diffs above> |
| 2026-04-14 | 25247592 | Initial environment variables | | 2026-04-14 | 2e682e59 | <infer what changed from the diffs above> |
| 2026-04-14 | b7b2ae6e | Initial Caddy reverse proxy setup | | 2026-04-14 | 25247592 | <infer what changed from the diffs above> |
Generated by Gremlin on 2026-04-15T03:46:23.992Z <Write a paragraph summarizing the evolution of this service based on the diffs above. If no diffs available, note that this is the initial documentation.>
Source: swarm/mealie.yaml
Review User Guide and Changelog sections ---
## Notes
- Generated by Gremlin on 2026-04-15T03:54:25.425Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections