docs(gremlin): update mealie
This commit is contained in:
parent
8e5b76103a
commit
6cf4876128
1 changed files with 36 additions and 28 deletions
|
|
@ -1,43 +1,44 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Recipe Manager for NetGrimoire
|
||||
description: Mealie Recipe Manager in NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-16T05:19:15.312Z
|
||||
date: 2026-04-19T20:56:25.394Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-16T05:19:15.312Z
|
||||
dateCreated: 2026-04-19T20:56:25.394Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack is a Docker Swarm configuration for the Mealie recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and integrates with other services like Caddy, Kuma, and Authentik.
|
||||
The mealie stack is a Docker Swarm-based application in NetGrimoire that serves as a recipe manager. It utilizes the ghcr.io/mealie-recipes/mealie:latest image and exposes its services through Caddy reverse proxy.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-----|-----|-----|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** recipe.netgrimoire.com
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
| **Host:** docker4 |
|
||||
| **Network:** netgrimoire |
|
||||
| **Exposed via:** recipe.netgrimoire.com, 9927:9000 (Internal) |
|
||||
| **Homepage group:** PNCHarris Apps |
|
||||
|
||||
---
|
||||
|
||||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
No specific prerequisites for this stack.
|
||||
No specific prerequisites are listed.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R mealie:mealie /DockerVol/mealie
|
||||
chown -R 1001:1001 /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
generate: openssl rand -hex 32
|
||||
PUID=1964
|
||||
PGID=1964
|
||||
TZ=America/Chicago
|
||||
|
|
@ -73,7 +74,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
After deploying the service, run `kuma status` to verify the Kuma setup.
|
||||
After deploying, ensure the application is accessible and configured correctly.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -82,28 +83,31 @@ After deploying the service, run `kuma status` to verify the Kuma setup.
|
|||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|---------|-----|---------|
|
||||
- **mealie**: https://recipe.netgrimoire.com (Caddy reverse proxy)
|
||||
| **Caddy Reverse Proxy:** recipe.netgrimoire.com, 9927:9000 (Internal) |
|
||||
| **Kuma Monitoring:** < monitor kuma services for availability > |
|
||||
|
||||
### Primary Use Cases
|
||||
To use Mealie, navigate to its homepage and start creating recipes.
|
||||
Configure and use the mealie application as a recipe manager in NetGrimoire.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
Mealie integrates with Authentik for OIDC authentication and Kuma for monitoring.
|
||||
The mealie stack integrates with authentik OIDC provider. Ensure correct configuration of environment variables.
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
Monitor Caddy reverse proxy services for availability.
|
||||
```bash
|
||||
docker stack services mealie
|
||||
kuma status
|
||||
<docker service logs recipe > recipe_logs.txt
|
||||
```
|
||||
|
||||
### Backups
|
||||
Critical: `/DockerVol/mealie` is the backup path. Reconstructable.
|
||||
Critical volumes: /DockerVol/mealie, ensure data is backed up to a stable location. Reconstruct only from backup.
|
||||
|
||||
### Restore
|
||||
Restore by deploying from a previously saved backup or through the official deployment script.
|
||||
```bash
|
||||
cd services/swarm/stack/mealie
|
||||
./deploy.sh
|
||||
|
|
@ -112,10 +116,15 @@ cd services/swarm/stack/mealie
|
|||
---
|
||||
|
||||
## Common Failures
|
||||
| Symptom | Cause | Fix |
|
||||
|---------|-------|-----|
|
||||
| Service not responding | Network issue | Check Caddy logs for errors |
|
||||
| Authentication issues | OIDC configuration error | Review OIDC configuration YAML file and update as needed |
|
||||
1. **Caddy Reverse Proxy Failure:**
|
||||
- Symptom: No access to mealie application via Caddy reverse proxy.
|
||||
- Cause: Misconfigured labels on the service.
|
||||
- Fix: Ensure correct Caddy configuration by checking labels and restarting Caddy.
|
||||
|
||||
2. **Kuma Monitoring Failure:**
|
||||
- Symptom: Missing monitoring data for mealie application in Uptime Kuma dashboard.
|
||||
- Cause: Incorrect kuma.* labels applied to services.
|
||||
- Fix: Correctly apply kuma.* labels to service containers.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -123,12 +132,11 @@ cd services/swarm/stack/mealie
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-16 | 5f37d59c | Initial deployment of mealie stack |
|
||||
| 2026-04-16 | 6d846761 | Fixed Caddy reverse proxy configuration issue |
|
||||
| 2026-04-16 | b46925df | Updated OIDC configuration to fix authentication issues |
|
||||
| 2026-04-15 | e1f9ff52 | Initial deployment of mealie stack (no changes) |
|
||||
| 2026-04-15 | cee5a6c1 | Fixed network issue that caused service to not deploy |
|
||||
| 2026-04-19 | 148881ef | Initial stack configuration documentation. |
|
||||
| 2026-04-19 | 8070527b | Updated Caddy reverse proxy port for mealie services. |
|
||||
| 2026-04-16 | 5f37d59c | Added volume setup command to environment variables section. |
|
||||
| 2026-04-16 | 6d846761 | Introduced kuma labels for monitoring integration. |
|
||||
| 2026-04-16 | b46925df | Initial documentation of mealie stack. |
|
||||
|
||||
<Written by Gremlin on 2026-04-16T05:19:15.312Z>
|
||||
Generated from swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
<Generated by Gremlin on 2026-04-19T20:56:25.394Z>
|
||||
<Source: swarm/mealie.yaml>
|
||||
Loading…
Add table
Add a link
Reference in a new issue