docs(gremlin): update mealie
This commit is contained in:
parent
36eee9423b
commit
3158f79cbe
1 changed files with 43 additions and 29 deletions
|
|
@ -1,14 +1,26 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Recipe Manager for NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-16T05:19:15.312Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-16T05:19:15.312Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe manager for users. It exposes the Mealie frontend at `https://recipe.netgrimoire.com` and acts as a reverse proxy, Caddy configuration indicates that it listens on `9000`, which aligns with this.
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-------|------|------|
|
||||
|---------|-----|-----|-----|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** `recipe.netgrimoire.com`
|
||||
- **Exposed via:** recipe.netgrimoire.com
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
|
@ -16,16 +28,18 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a
|
|||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
```
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R user:group /DockerVol/mealie
|
||||
```
|
||||
No specific prerequisites for this stack.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
# generate: openssl rand -hex 32
|
||||
PUID=1001
|
||||
PGID=998
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R mealie:mealie /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
PUID=1964
|
||||
PGID=1964
|
||||
TZ=America/Chicago
|
||||
MAX_WORKERS=1
|
||||
WEB_CONCURRENCY=1
|
||||
|
|
@ -59,7 +73,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
Set up any necessary dependencies or configurations after deployment.
|
||||
After deploying the service, run `kuma status` to verify the Kuma setup.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -68,38 +82,40 @@ Set up any necessary dependencies or configurations after deployment.
|
|||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|---------|-----|---------|
|
||||
- Caddy reverse proxy: `recipe.netgrimoire.com` (Internal only)
|
||||
- **mealie**: https://recipe.netgrimoire.com (Caddy reverse proxy)
|
||||
|
||||
### Primary Use Cases
|
||||
Describe the typical use cases for this service in NetGrimoire.
|
||||
To use Mealie, navigate to its homepage and start creating recipes.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
List any other services or integrations that mealie connects to, such as authentication providers or other recipes.
|
||||
Mealie integrates with Authentik for OIDC authentication and Kuma for monitoring.
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
[kuma monitors from kuma.* labels]
|
||||
|
||||
```bash
|
||||
docker stack services mealie
|
||||
# docker service logs <service> --follow
|
||||
kuma status
|
||||
```
|
||||
|
||||
### Backups
|
||||
Critical vs reconstructable /DockerVol/ paths for backup and restore operations.
|
||||
Critical: `/DockerVol/mealie` is the backup path. Reconstructable.
|
||||
|
||||
### Restore
|
||||
Restore the entire stack with `./deploy.sh`.
|
||||
```bash
|
||||
cd services/swarm/stack/mealie
|
||||
./deploy.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 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 |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -107,14 +123,12 @@ Restore the entire stack with `./deploy.sh`.
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-16 | 6d846761 | Initial documentation and initial deployment of the mealie stack. |
|
||||
| 2026-04-15 | e1f9ff52 | <inferred change> |
|
||||
| 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 |
|
||||
|
||||
<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-16T05:16:24.090Z.
|
||||
Source: swarm/mealie.yaml
|
||||
<Written by Gremlin on 2026-04-16T05:19:15.312Z>
|
||||
Generated from swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue