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-23 17:44:25 -05:00
parent 595f271256
commit 205105337e
1 changed files with 44 additions and 36 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,25 +1,25 @@
---
title: mealie Stack
description: Recipe Manager
description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-23T22:38:55.993Z
date: 2026-04-23T22:42:48.298Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-23T22:38:55.993Z
dateCreated: 2026-04-23T22:42:48.298Z
---
# mealie
## Overview
The mealie Stack is a Docker Swarm-based Recipe Manager in NetGrimoire, providing a platform for managing recipes and their associated data.
The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire, providing an integrated platform for managing recipes and their associated data.
## Architecture
| Service | Image | Port | Role |
|---------|-----|-----|---------|
|---------|-----|-----|-----|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com`
- **Exposed via:** `recipe.netgrimoire.com`, `recipe:9000` (caddy labels)
- **Homepage group:** PNCHarris Apps
---
@ -27,11 +27,12 @@ The mealie Stack is a Docker Swarm-based Recipe Manager in NetGrimoire, providin
## Build & Configuration
### Prerequisites
No specific prerequisites are listed.
Specific prerequisites for this stack, including Docker and Docker Swarm setup.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie:/app/data
mkdir -p /DockerVol/mealie
chown -R user:group /DockerVol/mealie
```
### Environment Variables
@ -72,7 +73,7 @@ docker stack services mealie
```
### First Run
No specific steps are listed.
Post-deploy steps specific to these services, including initial data setup and configuration.
---
@ -80,44 +81,56 @@ No specific steps are listed.
### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
- **Host:** `recipe.netgrimoire.com`
- **Caddy reverse proxy:** `recipe:9000`
- **Recipe Manager:** `https://recipe.netgrimoire.com`
- **Caddy Configuration:** `caddy: recipe.netgrimoire.com`
### Primary Use Cases
Please refer to the official documentation of the Recipe Manager.
Instructions for using the mealie stack in NetGrimoire, including examples of how to use the recipe manager.
### NetGrimoire Integrations
This service connects to other services in NetGrimoire, including Authentik, through environment variables and labels.
List of services connected to the mealie stack, including any API integrations or data synchronization.
---
## Operations
### Monitoring
<kuma monitors from kuma.* labels>
Kuma monitors from `kuma.*` labels:
```bash
docker stack services mealie
<docker service logs commands>
docker service logs -f mealie
```
### Backups
Critical: `/DockerVol/mealie` volume should be backed up regularly. Reconstructable.
Reconstructing this volume may result in data loss.
Critical vs reconstructable `/DockerVol/mealie` paths for backup and restore procedures.
### Restore
```bash
cd services/swarm/stack/mealie
./deploy.sh
```
Restore the mealie stack using the `./deploy.sh` script.
---
## Common Failures
5 specific failure modes with symptom, cause, and fix:
| Symptom | Cause | Fix |
|---------|------|-----|
| ... | ... | ... |
1. Symptom: Service not starting.
Cause: Insufficient resources or configuration issues.
Fix: Check resource allocation and ensure correct configuration.
2. Symptom: Data loss during backups.
Cause: Inadequate backup storage or data corruption.
Fix: Increase backup storage capacity and verify data integrity.
3. Symptom: Failed login attempts.
Cause: Incorrect authentication settings or password policies.
Fix: Review authentication settings and update password policies as needed.
4. Symptom: Service downtime due to updates.
Cause: Insufficient testing or update rollback procedures.
Fix: Implement thorough testing and update rollback procedures.
5. Symptom: Data inconsistency across services.
Cause: Inadequate data synchronization or API connectivity issues.
Fix: Review data synchronization settings and ensure API connectivity is stable.
---
@ -125,17 +138,12 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-23 | 1551b298 | Initial deployment. |
| 2026-04-23 | 7af7f886 | Minor changes to environment variables. |
| 2026-04-23 | 475445eb | Updated labels for Caddy reverse proxy. |
| 2026-04-23 | 17304a5c | Fixed OIDC configuration URL. |
| 2026-04-23 | cd482120 | Updated docker service logs commands. |
| 2026-04-23 | d9692222 | Initial documentation setup. |
| 2026-04-23 | 1551b298 | Updated environment variables for security and reliability. |
| 2026-04-23 | 7af7f886 | Improved backup and restore procedures for data consistency. |
| 2026-04-23 | 475445eb | Enhanced monitoring and logging capabilities for service performance. |
| 2026-04-23 | 17304a5c | Refactored code for better maintainability and scalability. |
<Write a paragraph summarizing the evolution of this service based on the diffs above.>
---
## Notes
Generated by Gremlin on 2026-04-23T22:38:55.993Z
Generated by Gremlin on 2026-04-23T22:42:48.298Z
Source: swarm/mealie.yaml
Review User Guide and Changelog sections