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:44:11 -05:00
parent 5d0090f233
commit a77e44396e
1 changed files with 36 additions and 29 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,27 +1,28 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager description: Recipe Manager for NetGrimoire
published: true published: true
date: 2026-04-16T02:21:29.671Z date: 2026-04-16T02:42:01.339Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-16T02:21:29.671Z dateCreated: 2026-04-16T02:42:01.339Z
--- ---
# mealie # mealie
## Overview ## Overview
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. The mealie stack is a Recipe Manager service for NetGrimoire, providing a web-based interface to manage recipes and access recipe-related data.
---
## 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`, `caddy:9000`
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
@ -30,11 +31,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 mealie:mealie /DockerVol/mealie chown -R 1001:1001 /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
@ -70,25 +72,27 @@ docker stack services mealie
``` ```
### First Run ### First Run
No specific post-deploy steps are required. After deploying the service, ensure that all necessary environment variables are set and the database is up-to-date.
--- ---
## User Guide ## User Guide
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
- Caddy: recipe.netgrimoire.com, 9000 |---------|-----|---------|
- Uptime Kuma: kuma.recipe.http.name=Mealie, https://recipe.netgrimoire.com - **Caddy Reverse Proxy:** `recipe.netgrimoire.com`, `caddy:9000`
- **Uptime Kuma Monitoring:** `kuma.recipe.http.name=Mealie` [link to monitoring dashboard]
### Primary Use Cases ### Primary Use Cases
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. To use the mealie stack, navigate to `https://recipe.netgrimoire.com` and log in with your credentials.
### NetGrimoire Integrations ### NetGrimoire Integrations
This service connects to Authentik and CrowdSec through environment variables and labels. The mealie stack integrates with other services through environment variables and labels, including:
* Authentik for OIDC authentication
* Uptime Kuma for monitoring
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
@ -98,7 +102,7 @@ docker service logs -f mealie
``` ```
### Backups ### Backups
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. Critical: Regular backups of the database and application data are necessary to prevent data loss.
### Restore ### Restore
```bash ```bash
@ -107,12 +111,14 @@ cd services/swarm/stack/mealie
``` ```
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Failure Mode | Symptoms | Cause | Fix |
- Service does not start. |-------------|----------|------|-----|
- Cause: Caddy or Uptime Kuma not running. | Service Not Responding | Service is not responding. | Insufficient resources or container restart required. | Restart service `docker service restart mealie` |
- Fix: Check the service logs and restart the services if necessary.
| 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.
--- ---
@ -120,12 +126,13 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | 52bc39f9 | Initial commit with swarm configuration. | | 2026-04-15 | b9007e9e | Initial documentation for mealie stack |
| 2026-04-15 | b490ae5d | Added environment variables for authentication. |
| 2026-04-15 | 89277943 | Fixed Caddy reverse proxy to point to the correct URL. |
| 2026-04-15 | 765f47e1 | Added Uptime Kuma monitoring configuration. |
| 2026-04-15 | 9bed890d | Updated environment variables for new authentik configuration. |
Generated by Gremlin on 2026-04-16T02:21:29.671Z <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.>
Source: swarm/mealie.yaml
Review User Guide and Changelog sections ---
## Notes
- Generated by Gremlin on 2026-04-16T02:42:01.339Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections