docs(gremlin): update mealie
This commit is contained in:
parent
a77e44396e
commit
42b842d766
1 changed files with 30 additions and 39 deletions
|
|
@ -1,28 +1,20 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Recipe Manager for NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-16T02:42:01.339Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-16T02:42:01.339Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack is a Recipe Manager service for NetGrimoire, providing a web-based interface to manage recipes and access recipe-related data.
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-------|------|-------|
|
||||
- **Host:** docker4
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** `recipe.netgrimoire.com`, `caddy:9000`
|
||||
- **Exposed via:** recipe.netgrimoire.com:9000
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
||||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
|
|
@ -31,12 +23,12 @@ No specific prerequisites are required for this stack.
|
|||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R 1001:1001 /DockerVol/mealie
|
||||
chown -R mealie:mealie /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
# generate: openssl rand -hex 32
|
||||
generate: openssl rand -hex 32
|
||||
PUID=1001
|
||||
PGID=998
|
||||
TZ=America/Chicago
|
||||
|
|
@ -72,37 +64,36 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
After deploying the service, ensure that all necessary environment variables are set and the database is up-to-date.
|
||||
No specific steps are required for the first run.
|
||||
|
||||
---
|
||||
|
||||
## User Guide
|
||||
|
||||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|---------|-----|---------|
|
||||
- **Caddy Reverse Proxy:** `recipe.netgrimoire.com`, `caddy:9000`
|
||||
- **Uptime Kuma Monitoring:** `kuma.recipe.http.name=Mealie` [link to monitoring dashboard]
|
||||
| Service | URL |
|
||||
|---------|-----|
|
||||
recipe.netgrimoire.com:9000 - Primary Recipe Manager Interface
|
||||
|
||||
### Primary Use Cases
|
||||
To use the mealie stack, navigate to `https://recipe.netgrimoire.com` and log in with your credentials.
|
||||
To access and manage recipes, navigate to recipe.netgrimoire.com:9000.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
The mealie stack integrates with other services through environment variables and labels, including:
|
||||
|
||||
* Authentik for OIDC authentication
|
||||
* Uptime Kuma for monitoring
|
||||
This stack integrates with authentik for OIDC authentication.
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
[kuma*]
|
||||
```bash
|
||||
docker stack services mealie
|
||||
docker service logs -f mealie
|
||||
```
|
||||
|
||||
### Backups
|
||||
Critical: Regular backups of the database and application data are necessary to prevent data loss.
|
||||
Critical data is stored in /DockerVol/mealie.
|
||||
|
||||
### Restore
|
||||
```bash
|
||||
|
|
@ -111,14 +102,12 @@ cd services/swarm/stack/mealie
|
|||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
| Failure Mode | Symptoms | Cause | Fix |
|
||||
|-------------|----------|------|-----|
|
||||
| Service Not Responding | Service is not responding. | Insufficient resources or container restart required. | Restart service `docker service restart mealie` |
|
||||
|
||||
| Database Issues | Data loss or inconsistencies in the database. | Critical: Regular backups are necessary to prevent data loss. | Check database logs and ensure regular backups are in place.|
|
||||
|
||||
| Caddy Configuration Error | Caddy is not configured correctly, leading to broken URLs or other issues. | Insufficient configuration options or incorrect settings. | Review Caddy configuration and update as needed.
|
||||
| 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. |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -126,13 +115,15 @@ cd services/swarm/stack/mealie
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-15 | b9007e9e | Initial documentation for mealie stack |
|
||||
|
||||
<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.>
|
||||
| 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 |
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
- Generated by Gremlin on 2026-04-16T02:42:01.339Z
|
||||
- Source: swarm/mealie.yaml
|
||||
- Review User Guide and Changelog sections
|
||||
Generated by Gremlin on 2026-04-16T02:56:04.916Z
|
||||
Source: swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue