traveler/Netgrimoire
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(gremlin): update mealie

Browse source
This commit is contained in:
traveler 2026-04-15 15:22:42 -05:00
parent 06571e7dd6
commit f28eeceb2f
1 changed files with 33 additions and 26 deletions
Download patch file Download diff file Expand all files Collapse all files

59
Netgrimoire/Services/mealie/mealie.md
View file

@ -1,24 +1,24 @@
--- ---
title: mealie Stack title: mealie Stack
description: Mealie recipe manager for NetGrimoire description: Recipe Manager
published: true published: true
date: 2026-04-15T19:56:44.655Z date: 2026-04-15T20:20:41.994Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-15T19:56:44.655Z dateCreated: 2026-04-15T20:20:41.994Z
--- ---
# mealie # mealie
## Overview ## 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------| |---------|-----|-----|-----|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com, Internal only - **Exposed via:** `recipe.netgrimoire.com:9000`
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -26,17 +26,16 @@ The mealie stack is a Docker Swarm configuration for the Mealie recipe manager s
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
This service requires Docker Swarm and the mealie:latest image. - Docker Swarm installed and configured
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R recipe:recipe /DockerVol/mealie chown -R user:user /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32
PUID=1001 PUID=1001
PGID=998 PGID=998
TZ=America/Chicago TZ=America/Chicago
@ -72,7 +71,7 @@ docker stack services mealie
``` ```
### First Run ### 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 ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
recipe.netgrimoire.com | https://recipe.netgrimoire.com | Access Mealie recipe manager | - **Caddy:** `recipe.netgrimoire.com`
- **Internal only:**
### Primary Use Cases ### 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 ### 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 ### Monitoring
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs mealie docker service logs -f mealie
``` ```
### Backups ### Backups
Critical data is stored in `/DockerVol/mealie`. Regular backups are recommended. - Critical: `/DockerVol/mealie`
- Reconstructable: `/DockerVol/mealie`
### Restore ### Restore
Run `./deploy.sh` to restore the service from backup. ```bash
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
| Failure | Symptom | Cause | Fix | | Symptom | Cause | Fix |
|--------|---------|------|-----| |---------|------|-----|
1. | Service not starting | Service is not available | Check network connectivity and ensure Docker Swarm is running | - Service not starting | Incorrect environment variables | Review and correct environment variables in .env file |
2. | Failed login attempts | Authentication issues | Check OIDC configuration and ensure Authentik credentials are correct | - Database issues | Database corruption or data loss | Run database repair script and recreate database |
3. | Recipe data loss | Data corruption | Regularly backup critical data to prevent loss |
--- ---
@ -120,11 +126,12 @@ Run `./deploy.sh` to restore the service from backup.
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | e7f6da52 | Initial documentation for mealie stack | | 2026-04-15 | e7979588 | Initial documentation created |
| 2026-04-15 | 158547e8 | Updated OIDC configuration and authentication settings | | 2026-04-14 | f555f48b | Updated environment variables to include new OIDC settings |
| 2026-04-15 | 7bf82e75 | Improved security measures for Mealie recipe manager |
| 2026-04-14 | f555f48b | Updated Docker Swarm configuration for improved performance |
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 Source: swarm/mealie.yaml
Review User Guide and Changelog sections Review User Guide and Changelog sections