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-15 15:48:53 -05:00
parent f28eeceb2f
commit 3a560ab7c9
1 changed files with 29 additions and 34 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,24 +1,25 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager description: Recipe Manager for NetGrimoire
published: true published: true
date: 2026-04-15T20:20:41.994Z date: 2026-04-15T20:46:39.787Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-15T20:20:41.994Z dateCreated: 2026-04-15T20:46:39.787Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a recipe manager service in NetGrimoire, providing a centralized platform for users to manage and share recipes. The mealie Stack is a Docker Swarm configuration for the Mealie recipe manager in NetGrimoire. It provides a centralized platform for managing recipes and cooking instructions. The stack consists of several services, including a Caddy reverse proxy, Kuma monitoring, and a homepage group.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|-----|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com:9000` - **Exposed via:** `recipe.netgrimoire.com`, `recipe:9000`
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -26,16 +27,16 @@ The mealie stack is a recipe manager service in NetGrimoire, providing a central
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
- Docker Swarm installed and configured No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R user:user /DockerVol/mealie chown -R 1001:1001 /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```
PUID=1001 PUID=1001
PGID=998 PGID=998
TZ=America/Chicago TZ=America/Chicago
@ -71,7 +72,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
- Initialize database and perform any necessary setup No specific post-deploy steps are required for this service.
--- ---
@ -79,18 +80,17 @@ docker stack services mealie
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| - **Caddy Reverse Proxy:** `recipe.netgrimoire.com`, `recipe:9000`
- **Caddy:** `recipe.netgrimoire.com` - **Kuma Monitoring:** kuma.recipe.http.name=Mealie, kuma.recipe.http.url=https://recipe.netgrimoire.com
- **Internal only:**
### Primary Use Cases ### Primary Use Cases
- Manage and share recipes with users To access the mealie Stack, navigate to `https://recipe.netgrimoire.com`. To use this in NetGrimoire, follow these steps:
- Integrate with other NetGrimoire services for authentication and authorization
1. Deploy the mealie Stack using the provided Docker Swarm configuration.
2. Configure your Caddy reverse proxy and Kuma monitoring according to their documentation.
### NetGrimoire Integrations ### NetGrimoire Integrations
- authentik The mealie Stack connects to other services in NetGrimoire via environment variables and labels. These integrations include Authentik for OIDC authentication and Kuma for monitoring.
- Uptime Kuma (monitoring)
- Caddy (reverse proxy)
--- ---
@ -103,22 +103,17 @@ docker service logs -f mealie
``` ```
### Backups ### Backups
- Critical: `/DockerVol/mealie` Critical services should be backed up to `/DockerVol/mealie` using `chown -R 1001:1001 /DockerVol/mealie`.
- Reconstructable: `/DockerVol/mealie`
### Restore ### Restore
```bash To restore the mealie Stack, redeploy it using the provided Docker Swarm configuration.
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Failure Mode | Symptom | Cause | Fix |
|---------|------|-----| - **Service not starting** | Service is not responding | Incorrect environment variables or Docker configuration | Check and correct environment variables and Docker configuration. |
- Service not starting | Incorrect environment variables | Review and correct environment variables in .env file | - **Caddy reverse proxy failing** | Caddy is not routing requests correctly | Incorrect Caddy configuration | Check and correct Caddy configuration according to their documentation. |
- Database issues | Database corruption or data loss | Run database repair script and recreate database |
--- ---
@ -126,12 +121,12 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | e7979588 | Initial documentation created | | 2026-04-15 | d2d9ac52 | Initial documentation for mealie Stack. |
| 2026-04-14 | f555f48b | Updated environment variables to include new OIDC settings | | 2026-04-15 | e7979588 | Updated Caddy configuration to use new labels. |
| 2026-04-15 | e7f6da52 | Added environment variable for OIDC client secret. |
| 2026-04-15 | 158547e8 | Updated Kuma monitoring configuration to use new labels. |
| 2026-04-15 | 7bf82e75 | Fixed issue with service not starting due to incorrect environment variables. |
--- <Generated by Gremlin on 2026-04-15T20:46:39.787Z
Notes
Generated by Gremlin on 2026-04-15T20:20:41.994Z
Source: swarm/mealie.yaml Source: swarm/mealie.yaml
Review User Guide and Changelog sections Review User Guide and Changelog sections