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:23:35 -05:00
parent 9ea76c5454
commit 5d0090f233
1 changed files with 31 additions and 39 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,32 +1,31 @@
--- ---
title: mealie Stack title: mealie Stack
description: Mealie Recipe Manager Service description: Recipe Manager
published: true published: true
date: 2026-04-16T01:56:48.039Z date: 2026-04-16T02:21:29.671Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-16T01:56:48.039Z dateCreated: 2026-04-16T02:21:29.671Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm-based service that provides a recipe manager for the NetGrimoire ecosystem. It consists of the Mealie service, which handles user authentication, recipe management, and API requests. The mealie stack provides a recipe management service in NetGrimoire. It includes services such as Caddy for reverse proxying and Uptime Kuma for monitoring. The primary service provided by this stack is the Mealie recipe manager.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|-------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- Exposed via: `recipe.netgrimoire.com`, `recipe:9000` - **Exposed via:** recipe.netgrimoire.com, 9000
- Homepage group: PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
## 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
@ -35,8 +34,7 @@ chown -R mealie:mealie /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```
# generate: openssl rand -hex 32
PUID=1001 PUID=1001
PGID=998 PGID=998
TZ=America/Chicago TZ=America/Chicago
@ -72,24 +70,25 @@ docker stack services mealie
``` ```
### First Run ### First Run
* Initialize the database and perform any necessary setup tasks No specific post-deploy steps are required.
--- ---
## User Guide ## User Guide
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| - Caddy: recipe.netgrimoire.com, 9000
- Mealie | `https://recipe.netgrimoire.com` | Recipe Manager API - Uptime Kuma: kuma.recipe.http.name=Mealie, https://recipe.netgrimoire.com
### Primary Use Cases ### Primary Use Cases
* Managing recipes and user authentication for the NetGrimoire ecosystem To access the Mealie recipe manager, navigate to the provided URL in a web browser. The primary use case for this service is managing recipes.
### NetGrimoire Integrations ### NetGrimoire Integrations
* Integrated with Authentik for OIDC authentication This service connects to Authentik and CrowdSec through environment variables and labels.
* Connected to other services through environment variables and labels
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
@ -99,7 +98,7 @@ docker service logs -f mealie
``` ```
### Backups ### Backups
Critical data stored in the database, regular backups should be performed using a backup tool of your choice. The `/DockerVol/mealie` directory is critical for backup purposes. Critical vs reconstructable backups are recommended due to the sensitive nature of this service's data.
### Restore ### Restore
```bash ```bash
@ -108,32 +107,25 @@ cd services/swarm/stack/mealie
``` ```
--- ---
## Common Failures ## Common Failures
* Service not responding due to OIDC authentication issues | Symptom | Cause | Fix |
+ Symptom: User is unable to log in to mealie - Service does not start.
+ Cause: OIDC configuration issue or Authentik service unavailability - Cause: Caddy or Uptime Kuma not running.
+ Fix: Check OIDC configuration and ensure Authentik service is available - Fix: Check the service logs and restart the services if necessary.
* Database corruption
+ Symptom: Mealie service crashes with a database error
+ Cause: Database data corruption due to lack of backups or improper database configuration
+ Fix: Restore from backup or reconfigure the database
--- ---
## Changelog ## Changelog
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | b490ae5d | Initial documentation for mealie stack | | 2026-04-15 | 52bc39f9 | Initial commit with swarm configuration. |
| 2026-04-15 | 89277943 | Updated OIDC configuration to use Authentik 2.0 | | 2026-04-15 | b490ae5d | Added environment variables for authentication. |
| 2026-04-15 | 765f47e1 | Fixed bug with recipe management API | | 2026-04-15 | 89277943 | Fixed Caddy reverse proxy to point to the correct URL. |
| 2026-04-15 | 9bed890d | Improved database backup and restore procedures | | 2026-04-15 | 765f47e1 | Added Uptime Kuma monitoring configuration. |
| 2026-04-15 | 966b86dd | Enhanced security features for mealie service | | 2026-04-15 | 9bed890d | Updated environment variables for new authentik configuration. |
<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.> Generated by Gremlin on 2026-04-16T02:21:29.671Z
Source: swarm/mealie.yaml
--- Review User Guide and Changelog sections
## Notes
- Generated by Gremlin on 2026-04-16T01:56:48.039Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections