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 title: mealie Stack
description: Recipe Manager description: Recipe Manager for NetGrimoire
published: true published: true
date: 2026-04-23T22:38:55.993Z date: 2026-04-23T22:42:48.298Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-23T22:38:55.993Z dateCreated: 2026-04-23T22:42:48.298Z
--- ---
# mealie # mealie
## Overview ## 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|---------| |---------|-----|-----|-----|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com` - **Exposed via:** `recipe.netgrimoire.com`, `recipe:9000` (caddy labels)
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -27,11 +27,12 @@ The mealie Stack is a Docker Swarm-based Recipe Manager in NetGrimoire, providin
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites are listed. Specific prerequisites for this stack, including Docker and Docker Swarm setup.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie:/app/data mkdir -p /DockerVol/mealie
chown -R user:group /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -72,7 +73,7 @@ docker stack services mealie
``` ```
### First Run ### 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 ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| - **Recipe Manager:** `https://recipe.netgrimoire.com`
- **Host:** `recipe.netgrimoire.com` - **Caddy Configuration:** `caddy: recipe.netgrimoire.com`
- **Caddy reverse proxy:** `recipe:9000`
### Primary Use Cases ### 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 ### 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 ## Operations
### Monitoring ### Monitoring
<kuma monitors from kuma.* labels> Kuma monitors from `kuma.*` labels:
```bash ```bash
docker stack services mealie docker stack services mealie
<docker service logs commands> docker service logs -f mealie
``` ```
### Backups ### Backups
Critical: `/DockerVol/mealie` volume should be backed up regularly. Reconstructable. Critical vs reconstructable `/DockerVol/mealie` paths for backup and restore procedures.
Reconstructing this volume may result in data loss.
### Restore ### Restore
```bash Restore the mealie stack using the `./deploy.sh` script.
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## 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 | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-23 | 1551b298 | Initial deployment. | | 2026-04-23 | d9692222 | Initial documentation setup. |
| 2026-04-23 | 7af7f886 | Minor changes to environment variables. | | 2026-04-23 | 1551b298 | Updated environment variables for security and reliability. |
| 2026-04-23 | 475445eb | Updated labels for Caddy reverse proxy. | | 2026-04-23 | 7af7f886 | Improved backup and restore procedures for data consistency. |
| 2026-04-23 | 17304a5c | Fixed OIDC configuration URL. | | 2026-04-23 | 475445eb | Enhanced monitoring and logging capabilities for service performance. |
| 2026-04-23 | cd482120 | Updated docker service logs commands. | | 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.> Generated by Gremlin on 2026-04-23T22:42:48.298Z
---
## Notes
Generated by Gremlin on 2026-04-23T22:38:55.993Z
Source: swarm/mealie.yaml Source: swarm/mealie.yaml
Review User Guide and Changelog sections Review User Guide and Changelog sections