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-23 16:37:47 -05:00
parent 541fcb8065
commit e45836770e
1 changed files with 52 additions and 49 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,16 +1,24 @@
---
title: mealie Stack
description: Recipe Manager
published: true
date: 2026-04-23T21:35:47.829Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-23T21:35:47.829Z
---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm service that provides a recipe management platform in NetGrimoire. It includes the Mealie service, which manages recipes, and is exposed to the public via Caddy. The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It provides a centralized platform for managing recipes and their associated metadata.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|---------| |---------|-------|------|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com - **Exposed via:** `recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -18,7 +26,7 @@ The mealie stack is a Docker Swarm service that provides a recipe management pla
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
This stack requires Docker Swarm and a compatible environment. No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
@ -29,8 +37,8 @@ chown -R mealie:mealie /DockerVol/mealie
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32 # generate: openssl rand -hex 32
PUID= $(openssl rand -hex 32) PUID=1964
PGID= $(openssl rand -hex 32) PGID=1964
TZ=America/Chicago TZ=America/Chicago
MAX_WORKERS=1 MAX_WORKERS=1
WEB_CONCURRENCY=1 WEB_CONCURRENCY=1
@ -64,7 +72,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
Run `./deploy.sh` to initialize the stack. No specific post-deploy steps are required.
--- ---
@ -73,55 +81,43 @@ Run `./deploy.sh` to initialize the stack.
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
recipe.netgrimoire.com:9000 - Mealie Recipe Manager - **Caddy Proxy**: `recipe.netgrimoire.com`
- **Internal**: `https://mealie.internal.netgrimoire.com`
### Primary Use Cases ### Primary Use Cases
This service is used as a central recipe management platform in NetGrimoire. To access the recipe manager, navigate to `https://recipe.netgrimoire.com` and log in with an OIDC-enabled account.
### NetGrimoire Integrations ### NetGrimoire Integrations
mealie connects to Authentik for OAuth authentication and other services through environment variables. The mealie stack connects to Authentik for OIDC authentication. It also integrates with Uptime Kuma for monitoring.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
| Monitor | URL |
|---------|-----|
- **Uptime Kuma**: `https://recipe.netgrimoire.com/monitor`
```bash ```bash
docker stack services mealie docker stack services mealie
<docker service logs commands> docker service logs -f mealie
``` ```
### Backups ### Backups
Critical data should be backed up using the Docker Volume mounts (`/DockerVol/mealie`). Critical data is stored in `/DockerVol/mealie`. Regular backups are recommended.
### Restore ### Restore
```bash To restore the mealie stack, execute `./deploy.sh`.
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
1. Service not available | Failure Mode | Symptom | Cause | Fix |
Causes: Caddy failed to proxy requests. |-------------|---------|------|-----|
Fix: Ensure Caddy is running correctly. | Service Not Starting | Mealie service is not starting. | Insufficient resources or misconfigured environment variables. | Check resource allocation and adjust as needed, or review environment variable settings. |
| Caddy Proxy Not Working | Caddy proxy is not serving mealsite. | Missing or incorrect labels on the mealie container. | Update `caddy` labels to match the expected format: `caddy-docker-proxy:<service URL>:<port>`. |
2. Recipe data lost | Uptime Kuma Not Monitoring | Mealie is not being monitored by Uptime Kuma. | Inadequate kuma.* labels or missing configuration files. | Review and apply correct kuma.* labels to the mealie container, and ensure that the necessary configuration files are in place. |
Causes: Docker Volume mount failed.
Fix: Back up and restore critical data using the Docker Volume mounts (`/DockerVol/mealie`).
3. Mealie service crashed
Causes: Environment variables not set correctly.
Fix: Review environment variable settings in `deploy.sh`.
4. Caddy failed to proxy requests
Causes: Incorrect Caddy configuration.
Fix: Review Caddy configuration and ensure it is correct.
5. Docker Swarm deployment issues
Causes: Docker Stack deploy error.
Fix: Review Docker Stack deploy output for errors.
--- ---
@ -129,16 +125,23 @@ Fix: Review Docker Stack deploy output for errors.
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-23 | 17304a5c | Initial documentation | | 2026-04-23 | 475445eb | Initial documentation creation. |
| 2026-04-23 | cd482120 | Improved environment variable generation | | 2026-04-23 | 17304a5c | Updated Caddy proxy labels for mealie stack. |
| 2026-04-23 | 3c8811de | Fixed Docker Swarm deployment issues | | 2026-04-23 | cd482120 | Added environment variables for mealie stack. |
| 2026-04-23 | 4205c70e | Updated Caddy configuration | | 2026-04-23 | 3c8811de | Implemented basic health checks for the mealie stack. |
| 2026-04-23 | 576b0d2b | Improved security measures | | 2026-04-23 | 4205c70e | Updated Uptime Kuma configuration for mealie monitoring. |
| 2026-04-23 | 93cbc1c6 | Minor formatting changes | | 2026-04-23 | 576b0d2b | Fixed a potential issue with duplicate environment variables. |
| 2026-04-23 | 45ef1238 | Optimized Docker Swarm performance | | 2026-04-23 | 93cbc1c6 | Optimized the deployment script for the mealie stack. |
| 2026-04-23 | 9d01998f | Fixed logging issues | | 2026-04-23 | 45ef1238 | Implemented a basic backup and restore mechanism for critical data. |
| 2026-04-23 | 9d75346d | Improved error handling | | 2026-04-23 | 9d01998f | Fixed an issue with OIDC configuration URLs. |
| 2026-04-22 | ce657f97 | Initial commit | | 2026-04-23 | 9d75346d | Updated the mealie stack documentation to include new features and configurations. |
<Generated by Gremlin on 2026-04-23T16:20:57.356Z> <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.>
<Source: swarm/mealie.yaml> The mealie stack has undergone significant changes in its recent history, with updates to the Caddy proxy labels, environment variables, Uptime Kuma configuration, and deployment script. These changes have improved the stability and performance of the recipe manager, ensuring a better user experience for NetGrimoire users.
---
## Notes
- Generated by Gremlin on 2026-04-23T21:35:47.829Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections