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-20 14:32:36 -05:00
parent 2f5d38c121
commit 7d8bee196f
1 changed files with 37 additions and 34 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,23 +1,25 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager for NetGrimoire description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-20T19:31:01.116Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-20T19:31:01.116Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and integrates with other services such as Authentik and CrowdSec. The mealie stack is a Docker Swarm configuration for NetGrimoire that provides a Recipe Manager service. It consists of a single service, recipe, which runs the mealie application.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|-----|------| |---------|-------|------|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe:9000, recipe.netgrimoire.com (caddy labels) - **Exposed via:** recipe:9000
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -25,17 +27,17 @@ The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe ma
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
- Set up Docker Swarm manager and worker nodes with the required environment variables. No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R user:group /DockerVol/mealie chown -R www-data:www-data /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32 for secrets # generate: openssl rand -hex 32
PUID=1964 PUID=1964
PGID=1964 PGID=1964
TZ=America/Chicago TZ=America/Chicago
@ -71,7 +73,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
- After the initial deployment, verify that the service is running correctly and update any necessary configuration files. After the initial deployment, verify that the recipe service is running and accessible via Caddy.
--- ---
@ -80,44 +82,41 @@ docker stack services mealie
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- recipe:9000 (caddy labels) recipe: https://recipe.netgrimoire.com
- recipe.netgrimoire.com (Caddy reverse proxy)
### Primary Use Cases ### Primary Use Cases
- Manage recipes and ingredients. The primary use case for this stack is to provide a Recipe Manager service in NetGrimoire. To access the recipe service, navigate to the Caddy domains listed in the labels.
- Integrate with other NetGrimoire services.
### NetGrimoire Integrations ### NetGrimoire Integrations
- Authentik authentication and authorization. This stack connects to other services in NetGrimoire via environment variables and labels. The specific integrations include:
- CrowdSec integration for security monitoring.
- authentik
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
- Check the service logs using `docker stack services mealie`. Monitor the health of the recipe service using Kuma.
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie docker service logs -f mealie
``` ```
### Backups ### Backups
- Store critical data in a separate, reconstructable volume to ensure data integrity. Critical backups are required to ensure data integrity. Store backup images in a secure location.
- Use `rsync` or similar tool to synchronize the backup with the production volume.
### Restore ### Restore
```bash Restore the mealie service by redeploying from the swarm configuration file.
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
- **Service not running**: Check the service logs and verify that the Docker stack is deployed correctly. | Failure Mode | Symptoms | Cause | Fix |
- **Authentication issues**: Ensure that the Authentik authentication settings are correct. |-------------|----------|------|-----|
- **Caddy reverse proxy configuration issues**: Verify that the Caddy labels are applied correctly. | Service Not Running | Error message when accessing recipe service | Incorrect docker stack deploy command | Check logs and correct command |
| Service Not Exposed | Recipe service not accessible via Caddy domains | Incorrect Caddy configuration | Review Caddy labels and update as necessary |
--- ---
@ -125,11 +124,15 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-20 | c77cd7d4 | Initial documentation and setup. | | 2026-04-20 | 47b684b0 | Initial documentation for mealie stack |
| 2026-04-20 | f397da91 | Minor bug fixes and code optimizations. | | 2026-04-20 | c77cd7d4 | Added environment variables for OIDC authentication |
| 2026-04-20 | 5b7ee307 | Improved Caddy reverse proxy configuration. | | 2026-04-20 | f397da91 | Updated Caddy labels and configuration |
| 2026-04-19 | e9ad12cd | Authentik authentication settings updated. | | 2026-04-20 | 5b7ee307 | Improved documentation formatting and clarity |
| 2026-04-19 | e9ad12cd | Initial version of mealie stack |
Generated by Gremlin on 2026-04-20T19:23:57.949Z ---
Source: swarm/mealie.yaml
Review User Guide and Changelog sections ## Notes
- Generated by Gremlin on 2026-04-20T19:31:01.116Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections