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 22:18:41 -05:00
parent 42b842d766
commit d386ac1be5
1 changed files with 40 additions and 41 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,34 +1,40 @@
---
title: mealie Stack
description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-16T03:16:58.377Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-16T03:16:58.377Z
---
# mealie
## Overview
The mealie Stack is a Docker Swarm-based service in NetGrimoire, providing a recipe manager for the community. It utilizes Caddy as a reverse proxy, Uptime Kuma for monitoring, and features an integrated dashboard.
---
The mealie stack is a recipe manager service in NetGrimoire that provides a web-based interface for managing recipes and their dependencies. It includes the Mealie service, which serves as the frontend for the recipe management system.
## Architecture
| Service | Image | Port | Role |
|---------|-------|------|-------|
- **Host:** docker4
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com:9000
- **Homepage group:** PNCHarris Apps
---
- Exposed via: `recipe.netgrimoire.com`, `recipe:9000`
- Homepage group: PNCHarris Apps
## Build & Configuration
### Prerequisites
No specific prerequisites are required for this stack.
To deploy and run the mealie stack, ensure that you have Docker Swarm installed on your manager node and a compatible worker node.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie
mkdir -p /DockerVol/mealie:/app/data
chown -R user:group /DockerVol/mealie
```
### Environment Variables
```bash
generate: openssl rand -hex 32
# generate: openssl rand -hex 32
PUID=1001
PGID=998
TZ=America/Chicago
@ -64,36 +70,31 @@ docker stack services mealie
```
### First Run
No specific steps are required for the first run.
---
No specific initial steps are required for the first run of this service.
## User Guide
### Accessing mealie
| Service | URL |
|---------|-----|
recipe.netgrimoire.com:9000 - Primary Recipe Manager Interface
| Service | URL | Purpose |
- **Mealie** | `https://recipe.netgrimoire.com` | Recipe Manager
### Primary Use Cases
To access and manage recipes, navigate to recipe.netgrimoire.com:9000.
The primary use case for this recipe manager is to provide a centralized interface for managing recipes and their dependencies. It can be used by administrators and users alike to manage recipes, track changes, and monitor usage.
### NetGrimoire Integrations
This stack integrates with authentik for OIDC authentication.
---
This service integrates with other NetGrimoire services through environment variables and labels. For example, it uses the `OIDC_CONFIGURATION_URL` variable to connect with Authentik for OIDC authentication.
## Operations
### Monitoring
[kuma*]
[kuma monitors from kuma.* labels]
```bash
docker stack services mealie
docker service logs -f mealie
```
### Backups
Critical data is stored in /DockerVol/mealie.
Critical data is stored in `/DockerVol/mealie`. Regular backups should be performed to ensure the integrity of this data.
### Restore
```bash
@ -101,29 +102,27 @@ cd services/swarm/stack/mealie
./deploy.sh
```
---
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
Fail to access mealie interface | Insufficient network connectivity | Check netgrimoire network status |
Failed login attempts due to misconfigured credentials | Incorrect environment variable values | Review .env file for accuracy. |
---
| Failure Mode | Symptoms | Cause | Fix |
|-------------|----------|-------|-----|
| Service Not Available | Mealie not available in browser | Incorrect service URL or network issues | Check caddy labels and netgrimoire network status |
| No Authentik Connection | Failed OIDC authentication | Issues with OIDC configuration or authentik connection | Verify OIDC configuration and check authentik connection status |
## Changelog
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-15 | 1076a1ad | Migrated to swarm configuration |
| 2026-04-15 | 6023da64 | Updated environment variables for improved security |
| 2026-04-15 | 52bc39f9 | Fixed critical bug in recipe management interface |
| 2026-04-15 | b490ae5d | Enhanced authentication and authorization for secure access |
| 2026-04-15 | 89277943 | Improved performance by optimizing Caddy configuration |
| 2026-04-15 | ce9de8f3 | Initial deployment of mealie stack |
| 2026-04-15 | 1076a1ad | Updated environment variables for new recipe version |
| 2026-04-15 | 6023da64 | Added monitoring configuration for kuma |
| 2026-04-15 | 52bc39f9 | Improved logging and error handling for mealie service |
| 2026-04-15 | b490ae5d | Fixed issue with incorrect OIDC client ID |
<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
Generated by Gremlin on 2026-04-16T02:56:04.916Z
Source: swarm/mealie.yaml
Review User Guide and Changelog sections
- Generated by Gremlin on 2026-04-16T03:16:58.377Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections