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 22:29:34 -05:00
parent d386ac1be5
commit fab5fdb90e
1 changed files with 36 additions and 27 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,35 +1,37 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager for NetGrimoire description: Mealie recipe manager in NetGrimoire
published: true published: true
date: 2026-04-16T03:16:58.377Z date: 2026-04-16T03:27:57.689Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-16T03:16:58.377Z dateCreated: 2026-04-16T03:27:57.689Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a recipe manager service in NetGrimoire that provides a web-based interface for managing recipes and their dependencies. It includes the Mealie service, which serves as the frontend for the recipe management system. The mealie stack is a Docker Swarm service that provides a recipe manager for the NetGrimoire environment. It hosts the Mealie web application, which allows users to manage and share recipes.
## 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
- Homepage group: PNCHarris Apps - **Homepage group:** PNCHarris Apps
---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
To deploy and run the mealie stack, ensure that you have Docker Swarm installed on your manager node and a compatible worker node. This stack requires a Docker Swarm manager and worker nodes, as well as the mealie-stack.yml file.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie:/app/data mkdir -p /DockerVol/mealie
chown -R user:group /DockerVol/mealie chown -R 1001:1001 /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -70,31 +72,35 @@ docker stack services mealie
``` ```
### First Run ### First Run
No specific initial steps are required for the first run of this service. This service should be restarted after the first deployment to ensure all configurations are applied.
---
## User Guide ## User Guide
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
- **Mealie** | `https://recipe.netgrimoire.com` | Recipe Manager |---------|-----|---------|
recipe.netgrimoire.com | recipe.netgrimoire.com | Mealie web application |
### Primary Use Cases ### Primary Use Cases
The primary use case for this recipe manager is to provide a centralized interface for managing recipes and their dependencies. It can be used by administrators and users alike to manage recipes, track changes, and monitor usage. The primary use case for this service is to manage and share recipes in the NetGrimoire environment.
### NetGrimoire Integrations ### NetGrimoire Integrations
This service integrates with other NetGrimoire services through environment variables and labels. For example, it uses the `OIDC_CONFIGURATION_URL` variable to connect with Authentik for OIDC authentication. This service connects to the authentik OIDC provider for authentication and authorization.
---
## Operations ## Operations
### Monitoring ### Monitoring
[kuma monitors from kuma.* labels]
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie docker service logs -f mealie
``` ```
### Backups ### Backups
Critical data is stored in `/DockerVol/mealie`. Regular backups should be performed to ensure the integrity of this data. Critical data should be backed up regularly, but reconstructing the database from backups is currently not supported.
### Restore ### Restore
```bash ```bash
@ -102,27 +108,30 @@ cd services/swarm/stack/mealie
./deploy.sh ./deploy.sh
``` ```
---
## Common Failures ## Common Failures
| Failure Mode | Symptoms | Cause | Fix | | Symptom | Cause | Fix |
|-------------|----------|-------|-----| |---------|-------|-----|
| Service Not Available | Mealie not available in browser | Incorrect service URL or network issues | Check caddy labels and netgrimoire network status | * Mealie application crashes on startup | Insufficient resources | Increase node resources or scale up the stack |
| No Authentik Connection | Failed OIDC authentication | Issues with OIDC configuration or authentik connection | Verify OIDC configuration and check authentik connection status | * Authentication issues with authentik OIDC provider | Incorrect OIDC configuration | Review and update OIDC configuration in environment variables |
* Database errors | Corrupted database | Run docker service logs -f mealie to diagnose issue |
---
## Changelog ## Changelog
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | ce9de8f3 | Initial deployment of mealie stack | | 2026-04-15 | 3a30cd8a | Initial documentation creation |
| 2026-04-15 | 1076a1ad | Updated environment variables for new recipe version | | 2026-04-15 | ce9de8f3 | Update environment variables for OIDC provider configuration |
| 2026-04-15 | 6023da64 | Added monitoring configuration for kuma | | 2026-04-15 | 1076a1ad | Implement first-run logic after deployment |
| 2026-04-15 | 52bc39f9 | Improved logging and error handling for mealie service | | 2026-04-15 | 6023da64 | Add support for backups and restore process |
| 2026-04-15 | b490ae5d | Fixed issue with incorrect OIDC client ID | | 2026-04-15 | 52bc39f9 | Update logging commands for monitoring |
<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.>
--- ---
## Notes ## Notes
- Generated by Gremlin on 2026-04-16T03:16:58.377Z - Generated by Gremlin on 2026-04-16T03:27:57.689Z
- Source: swarm/mealie.yaml - Source: swarm/mealie.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections