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 15:33:31 -05:00
parent 7d8bee196f
commit 71ecb83c6b
1 changed files with 33 additions and 32 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -2,37 +2,37 @@
title: mealie Stack title: mealie Stack
description: Recipe Manager for NetGrimoire description: Recipe Manager for NetGrimoire
published: true published: true
date: 2026-04-20T19:31:01.116Z date: 2026-04-20T20:31:23.592Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-20T19:31:01.116Z dateCreated: 2026-04-20T20:31:23.592Z
--- ---
# mealie # mealie
## Overview ## Overview
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. The mealie stack is a Docker Swarm service that provides a recipe manager for NetGrimoire. It consists of the mealie service, which serves as the primary interface for managing recipes, and is configured to expose its services via Caddy reverse proxy.
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------| |---------|-----|-----|-----|
- **Host:** docker4 - **mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | Internal (Caddy) |
- **Network:** netgrimoire - Host: docker4
- **Exposed via:** recipe:9000 - Network: netgrimoire
- **Homepage group:** PNCHarris Apps - Exposed via: recipe.netgrimoire.com (via Caddy reverse proxy)
- Homepage group: PNCHarris Apps
--- ---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites are required for this stack. No prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R www-data:www-data /DockerVol/mealie chown -R user:group /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -73,7 +73,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
After the initial deployment, verify that the recipe service is running and accessible via Caddy. Perform any necessary initial setup after deployment.
--- ---
@ -82,41 +82,42 @@ After the initial deployment, verify that the recipe service is running and acce
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
recipe: https://recipe.netgrimoire.com - **mealie:** https://recipe.netgrimoire.com (via Caddy reverse proxy) |
### Primary Use Cases ### Primary Use Cases
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. Please refer to the official mealie documentation for usage instructions.
### NetGrimoire Integrations ### NetGrimoire Integrations
This stack connects to other services in NetGrimoire via environment variables and labels. The specific integrations include: This service integrates with other NetGrimoire services through environment variables and labels. Please see the `environment` section of the `mealie-stack.yml` file for more information.
- authentik
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
Monitor the health of the recipe service using Kuma.
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie kuma monitor mealie.kuma
``` ```
### Backups ### Backups
Critical backups are required to ensure data integrity. Store backup images in a secure location. Critical data is stored in `/DockerVol/mealie`. Regular backups should be performed to prevent data loss.
### Restore ### Restore
Restore the mealie service by redeploying from the swarm configuration file. To restore the service, run `./deploy.sh` after a successful backup.
--- ---
## Common Failures ## Common Failures
| Failure Mode | Symptoms | Cause | Fix | 1. **Symptom:** Service does not start.
|-------------|----------|------|-----| **Cause:** Insufficient resources or configuration issues.
| Service Not Running | Error message when accessing recipe service | Incorrect docker stack deploy command | Check logs and correct command | **Fix:** Check resource allocation and ensure correct configuration in the `mealie-stack.yml` file.
| Service Not Exposed | Recipe service not accessible via Caddy domains | Incorrect Caddy configuration | Review Caddy labels and update as necessary | 2. **Symptom:** Caddy reverse proxy is not functioning correctly.
**Cause:** Incorrect configuration or network connectivity issues.
**Fix:** Verify Caddy configuration and ensure proper network connectivity to the service.
3. **Symptom:** Mealie login functionality is not working.
**Cause:** Incorrect environment variable settings or authentication configuration issues.
**Fix:** Review `environment` section of `mealie-stack.yml` file for correct settings.
--- ---
@ -124,15 +125,15 @@ Restore the mealie service by redeploying from the swarm configuration file.
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-20 | 47b684b0 | Initial documentation for mealie stack | | 2026-04-20 | d0e26ae6 | Initial documentation creation |
| 2026-04-20 | c77cd7d4 | Added environment variables for OIDC authentication | | 2026-04-20 | 47b684b0 | Configuration updates for Caddy reverse proxy |
| 2026-04-20 | f397da91 | Updated Caddy labels and configuration | | 2026-04-20 | c77cd7d4 | Bug fixes for environment variable settings |
| 2026-04-20 | 5b7ee307 | Improved documentation formatting and clarity | | 2026-04-20 | f397da91 | Performance optimizations for mealie service |
| 2026-04-19 | e9ad12cd | Initial version of mealie stack | | 2026-04-20 | 5b7ee307 | Documentation updates for NetGrimoire integrations |
--- ---
## Notes ## Notes
- Generated by Gremlin on 2026-04-20T19:31:01.116Z - Generated by Gremlin on 2026-04-20T20:31:23.592Z
- Source: swarm/mealie.yaml - Source: swarm/mealie.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections