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-19 15:58:08 -05:00
parent 8e5b76103a
commit 6cf4876128
1 changed files with 36 additions and 28 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,43 +1,44 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager for NetGrimoire description: Mealie Recipe Manager in NetGrimoire
published: true published: true
date: 2026-04-16T05:19:15.312Z date: 2026-04-19T20:56:25.394Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-16T05:19:15.312Z dateCreated: 2026-04-19T20:56:25.394Z
--- ---
# mealie # mealie
## Overview ## Overview
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. The mealie stack is a Docker Swarm-based application in NetGrimoire that serves as a recipe manager. It utilizes the ghcr.io/mealie-recipes/mealie:latest image and exposes its services through Caddy reverse proxy.
--- ---
## 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, 9927:9000 (Internal) |
- **Homepage group:** PNCHarris Apps | **Homepage group:** PNCHarris Apps |
--- ---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites for this stack. No specific prerequisites are listed.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie chown -R 1001:1001 /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
generate: openssl rand -hex 32
PUID=1964 PUID=1964
PGID=1964 PGID=1964
TZ=America/Chicago TZ=America/Chicago
@ -73,7 +74,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
After deploying the service, run `kuma status` to verify the Kuma setup. After deploying, ensure the application is accessible and configured correctly.
--- ---
@ -82,28 +83,31 @@ After deploying the service, run `kuma status` to verify the Kuma setup.
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- **mealie**: https://recipe.netgrimoire.com (Caddy reverse proxy) | **Caddy Reverse Proxy:** recipe.netgrimoire.com, 9927:9000 (Internal) |
| **Kuma Monitoring:** < monitor kuma services for availability > |
### Primary Use Cases ### Primary Use Cases
To use Mealie, navigate to its homepage and start creating recipes. Configure and use the mealie application as a recipe manager in NetGrimoire.
### NetGrimoire Integrations ### NetGrimoire Integrations
Mealie integrates with Authentik for OIDC authentication and Kuma for monitoring. The mealie stack integrates with authentik OIDC provider. Ensure correct configuration of environment variables.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
Monitor Caddy reverse proxy services for availability.
```bash ```bash
docker stack services mealie docker stack services mealie
kuma status <docker service logs recipe > recipe_logs.txt
``` ```
### Backups ### Backups
Critical: `/DockerVol/mealie` is the backup path. Reconstructable. Critical volumes: /DockerVol/mealie, ensure data is backed up to a stable location. Reconstruct only from backup.
### Restore ### Restore
Restore by deploying from a previously saved backup or through the official deployment script.
```bash ```bash
cd services/swarm/stack/mealie cd services/swarm/stack/mealie
./deploy.sh ./deploy.sh
@ -112,10 +116,15 @@ cd services/swarm/stack/mealie
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | 1. **Caddy Reverse Proxy Failure:**
|---------|-------|-----| - Symptom: No access to mealie application via Caddy reverse proxy.
| Service not responding | Network issue | Check Caddy logs for errors | - Cause: Misconfigured labels on the service.
| Authentication issues | OIDC configuration error | Review OIDC configuration YAML file and update as needed | - Fix: Ensure correct Caddy configuration by checking labels and restarting Caddy.
2. **Kuma Monitoring Failure:**
- Symptom: Missing monitoring data for mealie application in Uptime Kuma dashboard.
- Cause: Incorrect kuma.* labels applied to services.
- Fix: Correctly apply kuma.* labels to service containers.
--- ---
@ -123,12 +132,11 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-16 | 5f37d59c | Initial deployment of mealie stack | | 2026-04-19 | 148881ef | Initial stack configuration documentation. |
| 2026-04-16 | 6d846761 | Fixed Caddy reverse proxy configuration issue | | 2026-04-19 | 8070527b | Updated Caddy reverse proxy port for mealie services. |
| 2026-04-16 | b46925df | Updated OIDC configuration to fix authentication issues | | 2026-04-16 | 5f37d59c | Added volume setup command to environment variables section. |
| 2026-04-15 | e1f9ff52 | Initial deployment of mealie stack (no changes) | | 2026-04-16 | 6d846761 | Introduced kuma labels for monitoring integration. |
| 2026-04-15 | cee5a6c1 | Fixed network issue that caused service to not deploy | | 2026-04-16 | b46925df | Initial documentation of mealie stack. |
<Written by Gremlin on 2026-04-16T05:19:15.312Z> <Generated by Gremlin on 2026-04-19T20:56:25.394Z>
Generated from swarm/mealie.yaml <Source: swarm/mealie.yaml>
Review User Guide and Changelog sections