docs(gremlin): update mealie
This commit is contained in:
parent
06571e7dd6
commit
f28eeceb2f
1 changed files with 33 additions and 26 deletions
|
|
@ -1,24 +1,24 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Mealie recipe manager for NetGrimoire
|
||||
description: Recipe Manager
|
||||
published: true
|
||||
date: 2026-04-15T19:56:44.655Z
|
||||
date: 2026-04-15T20:20:41.994Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-15T19:56:44.655Z
|
||||
dateCreated: 2026-04-15T20:20:41.994Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack is a Docker Swarm configuration for the Mealie recipe manager service in NetGrimoire. It provides a secure and scalable way to manage recipes and access them through a web interface.
|
||||
The mealie stack is a recipe manager service in NetGrimoire, providing a centralized platform for users to manage and share recipes.
|
||||
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-------|------|------|
|
||||
|---------|-----|-----|-----|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** recipe.netgrimoire.com, Internal only
|
||||
- **Exposed via:** `recipe.netgrimoire.com:9000`
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
|
@ -26,17 +26,16 @@ The mealie stack is a Docker Swarm configuration for the Mealie recipe manager s
|
|||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
This service requires Docker Swarm and the mealie:latest image.
|
||||
- Docker Swarm installed and configured
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R recipe:recipe /DockerVol/mealie
|
||||
chown -R user:user /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
# generate: openssl rand -hex 32
|
||||
PUID=1001
|
||||
PGID=998
|
||||
TZ=America/Chicago
|
||||
|
|
@ -72,7 +71,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
Run the `./deploy.sh` script after deployment.
|
||||
- Initialize database and perform any necessary setup
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -81,13 +80,17 @@ Run the `./deploy.sh` script after deployment.
|
|||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|---------|-----|---------|
|
||||
recipe.netgrimoire.com | https://recipe.netgrimoire.com | Access Mealie recipe manager |
|
||||
- **Caddy:** `recipe.netgrimoire.com`
|
||||
- **Internal only:**
|
||||
|
||||
### Primary Use Cases
|
||||
Use Mealie to manage recipes and access them through the web interface.
|
||||
- Manage and share recipes with users
|
||||
- Integrate with other NetGrimoire services for authentication and authorization
|
||||
|
||||
### NetGrimoire Integrations
|
||||
This service connects to Authentik for OIDC authentication and Crowdsec for import purposes.
|
||||
- authentik
|
||||
- Uptime Kuma (monitoring)
|
||||
- Caddy (reverse proxy)
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -96,23 +99,26 @@ This service connects to Authentik for OIDC authentication and Crowdsec for impo
|
|||
### Monitoring
|
||||
```bash
|
||||
docker stack services mealie
|
||||
docker service logs mealie
|
||||
docker service logs -f mealie
|
||||
```
|
||||
|
||||
### Backups
|
||||
Critical data is stored in `/DockerVol/mealie`. Regular backups are recommended.
|
||||
- Critical: `/DockerVol/mealie`
|
||||
- Reconstructable: `/DockerVol/mealie`
|
||||
|
||||
### Restore
|
||||
Run `./deploy.sh` to restore the service from backup.
|
||||
```bash
|
||||
cd services/swarm/stack/mealie
|
||||
./deploy.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
| Failure | Symptom | Cause | Fix |
|
||||
|--------|---------|------|-----|
|
||||
1. | Service not starting | Service is not available | Check network connectivity and ensure Docker Swarm is running |
|
||||
2. | Failed login attempts | Authentication issues | Check OIDC configuration and ensure Authentik credentials are correct |
|
||||
3. | Recipe data loss | Data corruption | Regularly backup critical data to prevent loss |
|
||||
| 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 |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -120,11 +126,12 @@ Run `./deploy.sh` to restore the service from backup.
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-15 | e7f6da52 | Initial documentation for mealie stack |
|
||||
| 2026-04-15 | 158547e8 | Updated OIDC configuration and authentication settings |
|
||||
| 2026-04-15 | 7bf82e75 | Improved security measures for Mealie recipe manager |
|
||||
| 2026-04-14 | f555f48b | Updated Docker Swarm configuration for improved performance |
|
||||
| 2026-04-15 | e7979588 | Initial documentation created |
|
||||
| 2026-04-14 | f555f48b | Updated environment variables to include new OIDC settings |
|
||||
|
||||
Generated by Gremlin on 2026-04-15T19:56:44.655Z
|
||||
---
|
||||
|
||||
Notes
|
||||
Generated by Gremlin on 2026-04-15T20:20:41.994Z
|
||||
Source: swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue