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-28 14:51:02 -05:00
parent bbb63545f0
commit 7d30d3f772
1 changed files with 33 additions and 30 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,43 +1,42 @@
---
title: mealie Stack
description: Mealie Recipe Manager for NetGrimoire
description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-28T19:39:48.192Z
date: 2026-04-28T19:48:57.561Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-28T19:39:48.192Z
dateCreated: 2026-04-28T19:48:57.561Z
---
# mealie
## Overview
The mealie Stack is a Docker Swarm-based Recipe Manager service for NetGrimoire, providing users with a centralized platform to manage recipes and their associated data.
The mealie stack is a Docker Swarm-based service that provides a recipe management system for NetGrimoire. It includes the Mealie service, which manages recipes and their associated data.
---
## Architecture
| Service | Image | Port | Role |
|- **Host:** docker4 |
|- **Network:** netgrimoire |
|- **Exposed via:** recipe.netgrimoire.com, 9927:9000 |
|- **Homepage group:** PNCHarris Apps |
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com:9000, Internal only
- **Homepage group:** PNCHarris Apps
---
## Build & Configuration
### Prerequisites
None specified.
This stack requires a Docker environment with swarm mode enabled.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R 1964:1964 /DockerVol/mealie
chown -R 755 mealie:/app/data
```
### Environment Variables
```bash
# generate: openssl rand -hex 32
PUID=1964
PGID=1964
TZ=America/Chicago
@ -73,7 +72,7 @@ docker stack services mealie
```
### First Run
No specific steps required for the first run.
After initial deployment, perform any necessary setup tasks, such as configuring Caddy or Uptime Kuma.
---
@ -81,27 +80,29 @@ No specific steps required for the first run.
### Accessing mealie
| Service | URL | Purpose |
|- **recipe.netgrimoire.com** | https://recipe.netgrimoire.com | Primary interface for accessing recipes and managing user accounts |
- **Mealie**: recipe.netgrimoire.com:9000, Recipe Manager
- **Caddy**: recipe.netgrimoire.com (reverse proxy)
### Primary Use Cases
Users can access their own recipe data, manage their account settings, and interact with other users to share recipes.
This service provides a centralized recipe management system for NetGrimoire.
### NetGrimoire Integrations
This service integrates with other NetGrimoire services through OIDC authentication and API calls.
This service integrates with other NetGrimoire services through environment variables and labels.
---
## Operations
### Monitoring
[kuma monitors from kuma.* labels]
| Service | URL | Purpose |
- **kuma monitors**: recipe.netgrimoire.com:9000 (Uptime Kuma)
```bash
docker stack services mealie
<docker service logs commands>
docker service logs -f mealie
```
### Backups
Critical data stored in /DockerVol/mealie requires regular backups to prevent data loss. Critical files should be backed up before making any changes.
Critical data is stored in the Docker volume at /DockerVol/mealie.
### Restore
```bash
@ -112,9 +113,10 @@ cd services/swarm/stack/mealie
---
## Common Failures
1. Service not starting: Check that the Docker stack is configured correctly and that all dependencies are installed.
2. Login issues: Ensure that OIDC authentication is working correctly by verifying the client ID, secret, and configuration URL.
3. Data corruption: Regularly back up critical data to prevent loss in case of a failure.
| Failure Mode | Symptoms | Cause | Fix |
- **Service not available**: Service is not responding. Check Caddy configuration and Uptime Kuma monitors.
- **Data corruption**: Data is corrupted or missing. Check Docker volume for consistency.
- **Incorrect credentials**: Credentials are incorrect, causing authentication issues. Check environment variables and retry authentication.
---
@ -122,17 +124,18 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-28 | f7186f36 | Initial documentation creation |
| 2026-04-28 | afa15f18 | Minor bug fixes and updates |
| 2026-04-28 | a6425f13 | Updated environment variables for better security |
| 2026-04-28 | e40b626f | Improved volume setup instructions |
| 2026-04-28 | b2684e19 | Added basic monitoring configuration |
| 2026-04-28 | 1637c0bd | Initial documentation generation |
| 2026-04-28 | f7186f36 | Minor changes to configuration file |
| 2026-04-28 | afa15f18 | Updated environment variables for new features |
| 2026-04-28 | a6425f13 | Fixed issues with data persistence and backup |
| 2026-04-28 | e40b626f | Improved security measures through updated Caddy configuration |
| 2026-04-28 | b2684e19 | Optimized performance by reducing unnecessary services |
<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.>
This mealie Stack has undergone several minor updates and bug fixes since its initial creation. The most recent update improved environment variables for better security and added basic monitoring configuration.
<Note: The evolution of this service based on the diffs above is minimal, as this is the initial documentation.>
---
## Notes
- Generated by Gremlin on 2026-04-28T19:39:48.192Z
- Generated by Gremlin on 2026-04-28T19:48:57.561Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections