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 21:57:32 -05:00
parent a77e44396e
commit 42b842d766
1 changed files with 30 additions and 39 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,28 +1,20 @@
---
title: mealie Stack
description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-16T02:42:01.339Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-16T02:42:01.339Z
---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Recipe Manager service for NetGrimoire, providing a web-based interface to manage recipes and access recipe-related data. 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.
--- ---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|-------| |---------|-------|------|-------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com`, `caddy:9000` - **Exposed via:** recipe.netgrimoire.com:9000
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
@ -31,12 +23,12 @@ No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R 1001:1001 /DockerVol/mealie chown -R mealie:mealie /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
@ -72,37 +64,36 @@ docker stack services mealie
``` ```
### First Run ### First Run
After deploying the service, ensure that all necessary environment variables are set and the database is up-to-date. No specific steps are required for the first run.
--- ---
## User Guide ## User Guide
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL |
|---------|-----|---------| |---------|-----|
- **Caddy Reverse Proxy:** `recipe.netgrimoire.com`, `caddy:9000` recipe.netgrimoire.com:9000 - Primary Recipe Manager Interface
- **Uptime Kuma Monitoring:** `kuma.recipe.http.name=Mealie` [link to monitoring dashboard]
### Primary Use Cases ### Primary Use Cases
To use the mealie stack, navigate to `https://recipe.netgrimoire.com` and log in with your credentials. To access and manage recipes, navigate to recipe.netgrimoire.com:9000.
### NetGrimoire Integrations ### NetGrimoire Integrations
The mealie stack integrates with other services through environment variables and labels, including: This stack integrates with authentik for OIDC authentication.
* Authentik for OIDC authentication
* Uptime Kuma for monitoring
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
[kuma*]
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie docker service logs -f mealie
``` ```
### Backups ### Backups
Critical: Regular backups of the database and application data are necessary to prevent data loss. Critical data is stored in /DockerVol/mealie.
### Restore ### Restore
```bash ```bash
@ -111,14 +102,12 @@ cd services/swarm/stack/mealie
``` ```
--- ---
## Common Failures ## Common Failures
| Failure Mode | Symptoms | Cause | Fix | | Symptom | Cause | Fix |
|-------------|----------|------|-----| |---------|-------|-----|
| Service Not Responding | Service is not responding. | Insufficient resources or container restart required. | Restart service `docker service restart mealie` | 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. |
| Database Issues | Data loss or inconsistencies in the database. | Critical: Regular backups are necessary to prevent data loss. | Check database logs and ensure regular backups are in place.|
| Caddy Configuration Error | Caddy is not configured correctly, leading to broken URLs or other issues. | Insufficient configuration options or incorrect settings. | Review Caddy configuration and update as needed.
--- ---
@ -126,13 +115,15 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | b9007e9e | Initial documentation for mealie stack | | 2026-04-15 | 1076a1ad | Migrated to swarm configuration |
| 2026-04-15 | 6023da64 | Updated environment variables for improved security |
<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.> | 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 |
--- ---
## Notes ## Notes
- Generated by Gremlin on 2026-04-16T02:42:01.339Z Generated by Gremlin on 2026-04-16T02:56:04.916Z
- Source: swarm/mealie.yaml Source: swarm/mealie.yaml
- Review User Guide and Changelog sections Review User Guide and Changelog sections