docs(gremlin): update mealie
This commit is contained in:
parent
42b842d766
commit
d386ac1be5
1 changed files with 40 additions and 41 deletions
|
|
@ -1,34 +1,40 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Recipe Manager for NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-16T03:16:58.377Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-16T03:16:58.377Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie Stack is a Docker Swarm-based service in NetGrimoire, providing a recipe manager for the community. It utilizes Caddy as a reverse proxy, Uptime Kuma for monitoring, and features an integrated dashboard.
|
||||
|
||||
---
|
||||
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.
|
||||
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-------|------|-------|
|
||||
|---------|-------|------|------|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** recipe.netgrimoire.com:9000
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
- Exposed via: `recipe.netgrimoire.com`, `recipe:9000`
|
||||
- Homepage group: PNCHarris Apps
|
||||
|
||||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
No specific prerequisites are required for this stack.
|
||||
To deploy and run the mealie stack, ensure that you have Docker Swarm installed on your manager node and a compatible worker node.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R mealie:mealie /DockerVol/mealie
|
||||
mkdir -p /DockerVol/mealie:/app/data
|
||||
chown -R user:group /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
generate: openssl rand -hex 32
|
||||
# generate: openssl rand -hex 32
|
||||
PUID=1001
|
||||
PGID=998
|
||||
TZ=America/Chicago
|
||||
|
|
@ -64,36 +70,31 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
No specific steps are required for the first run.
|
||||
|
||||
---
|
||||
No specific initial steps are required for the first run of this service.
|
||||
|
||||
## User Guide
|
||||
|
||||
### Accessing mealie
|
||||
| Service | URL |
|
||||
|---------|-----|
|
||||
recipe.netgrimoire.com:9000 - Primary Recipe Manager Interface
|
||||
| Service | URL | Purpose |
|
||||
- **Mealie** | `https://recipe.netgrimoire.com` | Recipe Manager
|
||||
|
||||
### Primary Use Cases
|
||||
To access and manage recipes, navigate to recipe.netgrimoire.com:9000.
|
||||
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.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
This stack integrates with authentik for OIDC authentication.
|
||||
|
||||
---
|
||||
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.
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
[kuma*]
|
||||
[kuma monitors from kuma.* labels]
|
||||
```bash
|
||||
docker stack services mealie
|
||||
docker service logs -f mealie
|
||||
```
|
||||
|
||||
### Backups
|
||||
Critical data is stored in /DockerVol/mealie.
|
||||
Critical data is stored in `/DockerVol/mealie`. Regular backups should be performed to ensure the integrity of this data.
|
||||
|
||||
### Restore
|
||||
```bash
|
||||
|
|
@ -101,29 +102,27 @@ cd services/swarm/stack/mealie
|
|||
./deploy.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
| Symptom | Cause | Fix |
|
||||
|---------|-------|-----|
|
||||
Fail to access mealie interface | Insufficient network connectivity | Check netgrimoire network status |
|
||||
Failed login attempts due to misconfigured credentials | Incorrect environment variable values | Review .env file for accuracy. |
|
||||
|
||||
---
|
||||
| Failure Mode | Symptoms | Cause | Fix |
|
||||
|-------------|----------|-------|-----|
|
||||
| Service Not Available | Mealie not available in browser | Incorrect service URL or network issues | Check caddy labels and netgrimoire network status |
|
||||
| No Authentik Connection | Failed OIDC authentication | Issues with OIDC configuration or authentik connection | Verify OIDC configuration and check authentik connection status |
|
||||
|
||||
## Changelog
|
||||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-15 | 1076a1ad | Migrated to swarm configuration |
|
||||
| 2026-04-15 | 6023da64 | Updated environment variables for improved security |
|
||||
| 2026-04-15 | 52bc39f9 | Fixed critical bug in recipe management interface |
|
||||
| 2026-04-15 | b490ae5d | Enhanced authentication and authorization for secure access |
|
||||
| 2026-04-15 | 89277943 | Improved performance by optimizing Caddy configuration |
|
||||
| 2026-04-15 | ce9de8f3 | Initial deployment of mealie stack |
|
||||
| 2026-04-15 | 1076a1ad | Updated environment variables for new recipe version |
|
||||
| 2026-04-15 | 6023da64 | Added monitoring configuration for kuma |
|
||||
| 2026-04-15 | 52bc39f9 | Improved logging and error handling for mealie service |
|
||||
| 2026-04-15 | b490ae5d | Fixed issue with incorrect OIDC client ID |
|
||||
|
||||
<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
|
||||
Generated by Gremlin on 2026-04-16T02:56:04.916Z
|
||||
Source: swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
- Generated by Gremlin on 2026-04-16T03:16:58.377Z
|
||||
- Source: swarm/mealie.yaml
|
||||
- Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue