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-16 00:21:12 -05:00
parent 36eee9423b
commit 3158f79cbe
1 changed files with 43 additions and 29 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,14 +1,26 @@
---
title: mealie Stack
description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-16T05:19:15.312Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-16T05:19:15.312Z
---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe manager for users. It exposes the Mealie frontend at `https://recipe.netgrimoire.com` and acts as a reverse proxy, Caddy configuration indicates that it listens on `9000`, which aligns with this. The mealie stack is a Docker Swarm configuration for the Mealie recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and integrates with other services like Caddy, Kuma, and Authentik.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------| |---------|-----|-----|-----|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com` - **Exposed via:** recipe.netgrimoire.com
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -16,16 +28,18 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
``` No specific prerequisites for this stack.
mkdir -p /DockerVol/mealie
chown -R user:group /DockerVol/mealie
```
### Volume Setup ### Volume Setup
```bash ```bash
# generate: openssl rand -hex 32 mkdir -p /DockerVol/mealie
PUID=1001 chown -R mealie:mealie /DockerVol/mealie
PGID=998 ```
### Environment Variables
```bash
PUID=1964
PGID=1964
TZ=America/Chicago TZ=America/Chicago
MAX_WORKERS=1 MAX_WORKERS=1
WEB_CONCURRENCY=1 WEB_CONCURRENCY=1
@ -59,7 +73,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
Set up any necessary dependencies or configurations after deployment. After deploying the service, run `kuma status` to verify the Kuma setup.
--- ---
@ -68,38 +82,40 @@ Set up any necessary dependencies or configurations after deployment.
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- Caddy reverse proxy: `recipe.netgrimoire.com` (Internal only) - **mealie**: https://recipe.netgrimoire.com (Caddy reverse proxy)
### Primary Use Cases ### Primary Use Cases
Describe the typical use cases for this service in NetGrimoire. To use Mealie, navigate to its homepage and start creating recipes.
### NetGrimoire Integrations ### NetGrimoire Integrations
List any other services or integrations that mealie connects to, such as authentication providers or other recipes. Mealie integrates with Authentik for OIDC authentication and Kuma for monitoring.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
[kuma monitors from kuma.* labels]
```bash ```bash
docker stack services mealie docker stack services mealie
# docker service logs <service> --follow kuma status
``` ```
### Backups ### Backups
Critical vs reconstructable /DockerVol/ paths for backup and restore operations. Critical: `/DockerVol/mealie` is the backup path. Reconstructable.
### Restore ### Restore
Restore the entire stack with `./deploy.sh`. ```bash
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Symptom | Cause | Fix |
|---------|-------|-----| |---------|-------|-----|
| | | | | Service not responding | Network issue | Check Caddy logs for errors |
| Authentication issues | OIDC configuration error | Review OIDC configuration YAML file and update as needed |
--- ---
@ -107,14 +123,12 @@ Restore the entire stack with `./deploy.sh`.
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-16 | 6d846761 | Initial documentation and initial deployment of the mealie stack. | | 2026-04-16 | 5f37d59c | Initial deployment of mealie stack |
| 2026-04-15 | e1f9ff52 | <inferred change> | | 2026-04-16 | 6d846761 | Fixed Caddy reverse proxy configuration issue |
| 2026-04-16 | b46925df | Updated OIDC configuration to fix authentication issues |
| 2026-04-15 | e1f9ff52 | Initial deployment of mealie stack (no changes) |
| 2026-04-15 | cee5a6c1 | Fixed network issue that caused service to not deploy |
<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.> <Written by Gremlin on 2026-04-16T05:19:15.312Z>
Generated from swarm/mealie.yaml
---
## Notes
Generated by Gremlin on 2026-04-16T05:16:24.090Z.
Source: swarm/mealie.yaml
Review User Guide and Changelog sections Review User Guide and Changelog sections