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

79
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 # mealie
## Overview ## 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 ## 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
---
## Build & Configuration ## Build & Configuration
### Prerequisites ### 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 ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie:/app/data
chown -R mealie:mealie /DockerVol/mealie chown -R user:group /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
generate: openssl rand -hex 32 # generate: openssl rand -hex 32
PUID=1001 PUID=1001
PGID=998 PGID=998
TZ=America/Chicago TZ=America/Chicago
@ -64,36 +70,31 @@ docker stack services mealie
``` ```
### First Run ### 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 ## User Guide
### Accessing mealie ### Accessing mealie
| Service | URL | | Service | URL | Purpose |
|---------|-----| - **Mealie** | `https://recipe.netgrimoire.com` | Recipe Manager
recipe.netgrimoire.com:9000 - Primary Recipe Manager Interface
### Primary Use Cases ### 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 ### 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 ## Operations
### Monitoring ### Monitoring
[kuma*] [kuma monitors from kuma.* labels]
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie docker service logs -f mealie
``` ```
### Backups ### 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 ### Restore
```bash ```bash
@ -101,29 +102,27 @@ cd services/swarm/stack/mealie
./deploy.sh ./deploy.sh
``` ```
---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Failure Mode | Symptoms | Cause | Fix |
|---------|-------|-----| |-------------|----------|-------|-----|
Fail to access mealie interface | Insufficient network connectivity | Check netgrimoire network status | | Service Not Available | Mealie not available in browser | Incorrect service URL or network issues | Check caddy labels and netgrimoire network status |
Failed login attempts due to misconfigured credentials | Incorrect environment variable values | Review .env file for accuracy. | | No Authentik Connection | Failed OIDC authentication | Issues with OIDC configuration or authentik connection | Verify OIDC configuration and check authentik connection status |
---
## Changelog ## Changelog
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | 1076a1ad | Migrated to swarm configuration | | 2026-04-15 | ce9de8f3 | Initial deployment of mealie stack |
| 2026-04-15 | 6023da64 | Updated environment variables for improved security | | 2026-04-15 | 1076a1ad | Updated environment variables for new recipe version |
| 2026-04-15 | 52bc39f9 | Fixed critical bug in recipe management interface | | 2026-04-15 | 6023da64 | Added monitoring configuration for kuma |
| 2026-04-15 | b490ae5d | Enhanced authentication and authorization for secure access | | 2026-04-15 | 52bc39f9 | Improved logging and error handling for mealie service |
| 2026-04-15 | 89277943 | Improved performance by optimizing Caddy configuration | | 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 ## Notes
Generated by Gremlin on 2026-04-16T02:56:04.916Z - Generated by Gremlin on 2026-04-16T03:16:58.377Z
Source: swarm/mealie.yaml - Source: swarm/mealie.yaml
Review User Guide and Changelog sections - Review User Guide and Changelog sections