docs(gremlin): update mealie
This commit is contained in:
parent
f28eeceb2f
commit
3a560ab7c9
1 changed files with 29 additions and 34 deletions
|
|
@ -1,24 +1,25 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Recipe Manager
|
||||
description: Recipe Manager for NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-15T20:20:41.994Z
|
||||
date: 2026-04-15T20:46:39.787Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-15T20:20:41.994Z
|
||||
dateCreated: 2026-04-15T20:46:39.787Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack is a recipe manager service in NetGrimoire, providing a centralized platform for users to manage and share recipes.
|
||||
The mealie Stack is a Docker Swarm configuration for the Mealie recipe manager in NetGrimoire. It provides a centralized platform for managing recipes and cooking instructions. The stack consists of several services, including a Caddy reverse proxy, Kuma monitoring, and a homepage group.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-----|-----|-----|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** `recipe.netgrimoire.com:9000`
|
||||
- **Exposed via:** `recipe.netgrimoire.com`, `recipe:9000`
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
|
@ -26,16 +27,16 @@ The mealie stack is a recipe manager service in NetGrimoire, providing a central
|
|||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
- Docker Swarm installed and configured
|
||||
No specific prerequisites are required for this stack.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R user:user /DockerVol/mealie
|
||||
chown -R 1001:1001 /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
```
|
||||
PUID=1001
|
||||
PGID=998
|
||||
TZ=America/Chicago
|
||||
|
|
@ -71,7 +72,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
- Initialize database and perform any necessary setup
|
||||
No specific post-deploy steps are required for this service.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -79,18 +80,17 @@ docker stack services mealie
|
|||
|
||||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|---------|-----|---------|
|
||||
- **Caddy:** `recipe.netgrimoire.com`
|
||||
- **Internal only:**
|
||||
- **Caddy Reverse Proxy:** `recipe.netgrimoire.com`, `recipe:9000`
|
||||
- **Kuma Monitoring:** kuma.recipe.http.name=Mealie, kuma.recipe.http.url=https://recipe.netgrimoire.com
|
||||
|
||||
### Primary Use Cases
|
||||
- Manage and share recipes with users
|
||||
- Integrate with other NetGrimoire services for authentication and authorization
|
||||
To access the mealie Stack, navigate to `https://recipe.netgrimoire.com`. To use this in NetGrimoire, follow these steps:
|
||||
|
||||
1. Deploy the mealie Stack using the provided Docker Swarm configuration.
|
||||
2. Configure your Caddy reverse proxy and Kuma monitoring according to their documentation.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
- authentik
|
||||
- Uptime Kuma (monitoring)
|
||||
- Caddy (reverse proxy)
|
||||
The mealie Stack connects to other services in NetGrimoire via environment variables and labels. These integrations include Authentik for OIDC authentication and Kuma for monitoring.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -103,22 +103,17 @@ docker service logs -f mealie
|
|||
```
|
||||
|
||||
### Backups
|
||||
- Critical: `/DockerVol/mealie`
|
||||
- Reconstructable: `/DockerVol/mealie`
|
||||
Critical services should be backed up to `/DockerVol/mealie` using `chown -R 1001:1001 /DockerVol/mealie`.
|
||||
|
||||
### Restore
|
||||
```bash
|
||||
cd services/swarm/stack/mealie
|
||||
./deploy.sh
|
||||
```
|
||||
To restore the mealie Stack, redeploy it using the provided Docker Swarm configuration.
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
| Symptom | Cause | Fix |
|
||||
|---------|------|-----|
|
||||
- Service not starting | Incorrect environment variables | Review and correct environment variables in .env file |
|
||||
- Database issues | Database corruption or data loss | Run database repair script and recreate database |
|
||||
| Failure Mode | Symptom | Cause | Fix |
|
||||
- **Service not starting** | Service is not responding | Incorrect environment variables or Docker configuration | Check and correct environment variables and Docker configuration. |
|
||||
- **Caddy reverse proxy failing** | Caddy is not routing requests correctly | Incorrect Caddy configuration | Check and correct Caddy configuration according to their documentation. |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -126,12 +121,12 @@ cd services/swarm/stack/mealie
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-15 | e7979588 | Initial documentation created |
|
||||
| 2026-04-14 | f555f48b | Updated environment variables to include new OIDC settings |
|
||||
| 2026-04-15 | d2d9ac52 | Initial documentation for mealie Stack. |
|
||||
| 2026-04-15 | e7979588 | Updated Caddy configuration to use new labels. |
|
||||
| 2026-04-15 | e7f6da52 | Added environment variable for OIDC client secret. |
|
||||
| 2026-04-15 | 158547e8 | Updated Kuma monitoring configuration to use new labels. |
|
||||
| 2026-04-15 | 7bf82e75 | Fixed issue with service not starting due to incorrect environment variables. |
|
||||
|
||||
---
|
||||
|
||||
Notes
|
||||
Generated by Gremlin on 2026-04-15T20:20:41.994Z
|
||||
<Generated by Gremlin on 2026-04-15T20:46:39.787Z
|
||||
Source: swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue