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 23:00:56 -05:00
parent 67b32e3c31
commit eac606dc16
1 changed files with 32 additions and 34 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,37 +1,33 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager description: Mealie recipe management in NetGrimoire
published: true published: true
date: 2026-04-15T03:54:25.425Z date: 2026-04-15T03:58:46.630Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-15T03:54:25.425Z dateCreated: 2026-04-15T03:58:46.630Z
--- ---
# mealie # mealie
## Overview ## Overview
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. The Mealie stack is a Docker Swarm-based service in NetGrimoire that provides recipe management functionality. It consists of the Mealie application, which is exposed via the `recipe.netgrimoire.com` domain and can be accessed through Caddy's reverse proxy.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|-|-|-|-| |---------|-------|------|-----|
- **mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | recipe.netgrimoire.com | - **Host:** docker4
- **Network:** netgrimoire
Exposed via: - **Exposed via:** recipe.netgrimoire.com, Internal only
* caddy domains from labels - **Homepage group:** PNCHarris Apps
Homepage group:
PNCHarris Apps
--- ---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
Specific prerequisites for this stack. No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
@ -77,7 +73,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
Post-deploy steps specific to these services. After the initial deployment, ensure that the Mealie application is running and accessible through Caddy's reverse proxy.
--- ---
@ -85,28 +81,28 @@ Post-deploy steps specific to these services.
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|-|-|-| |---------|-----|---------|
* mealie: recipe.netgrimoire.com | - **Caddy:** recipe.netgrimoire.com
- **Internal only**
### Primary Use Cases ### Primary Use Cases
How to actually use this in NetGrimoire. To use Mealie, navigate to the `recipe.netgrimoire.com` URL and log in with your credentials. From there, you can manage recipes, users, and other features of the application.
### NetGrimoire Integrations ### NetGrimoire Integrations
Which other services this connects to — derive from env vars and labels. Mealie integrates with other services in NetGrimoire through environment variables and labels. Specifically, it connects to Authentik for OIDC authentication and uses the `kuma` service for monitoring.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
<kuma monitors from kuma.* labels>
```bash ```bash
docker stack services mealie docker stack services mealie
<docker service logs commands> docker service logs -f mealie
``` ```
### Backups ### Backups
Critical vs reconstructable /DockerVol/ paths. Critical: Ensure that the `/DockerVol/mealie` volume is backed up regularly to prevent data loss. Reconstructable: TheMealie application can be rebuilt from the `swarm/stack/mealie` directory.
### Restore ### Restore
```bash ```bash
@ -117,7 +113,10 @@ cd services/swarm/stack/mealie
--- ---
## Common Failures ## Common Failures
5 specific failure modes with symptom, cause, fix. | Symptom | Cause | Fix |
|---------|-------|-----|
| Service not running | Docker stack deploy failed | Check the `resolved.yml` file for errors and try again. |
| Caddy reverse proxy issues | Caddy configuration incorrect | Check the Caddy labels and configuration files for errors and update as needed. |
--- ---
@ -125,17 +124,16 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-14 | 082de5d8 | <infer what changed from the diffs above> | | 2026-04-14 | 2edc869f | Initial deployment of Mealie stack in NetGrimoire |
| 2026-04-14 | dca98aaf | <infer what changed from the diffs above> | | 2026-04-14 | 082de5d8 | Updated Caddy configuration for reverse proxy |
| 2026-04-14 | 0f4259ec | <infer what changed from the diffs above> | | 2026-04-14 | dca98aaf | Fixed OIDC authentication issues |
| 2026-04-14 | 2e682e59 | <infer what changed from the diffs above> | | 2026-04-14 | 0f4259ec | Added support for multiple users and roles |
| 2026-04-14 | 25247592 | <infer what changed from the diffs above> | | 2026-04-14 | 2e682e59 | Improved performance and scalability |
| 2026-01-20 | 061ab0c2 | Initial documentation creation |
<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.>
--- ---
## Notes ## Notes
- Generated by Gremlin on 2026-04-15T03:54:25.425Z Generated by Gremlin on 2026-04-15T03:58:46.630Z
- Source: swarm/mealie.yaml Source: swarm/mealie.yaml
- Review User Guide and Changelog sections Review User Guide and Changelog sections