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 22:56:41 -05:00
parent cc768fa193
commit 72cb1f26df
1 changed files with 40 additions and 37 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,28 +1,24 @@
--- ---
title: mealie Stack title: mealie Stack
description: Mealie Stack for NetGrimoire Recipe Manager description: Mealie recipe manager for NetGrimoire
published: true published: true
date: 2026-04-16T03:42:36.036Z date: 2026-04-16T03:54:53.691Z
tags: docker, swarm, mealie, netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-16T03:42:36.036Z dateCreated: 2026-04-16T03:54:53.691Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm configuration for the Mealie Recipe Manager in NetGrimoire. It includes the recipe manager service, which provides a web interface for managing recipes, and relies on other services such as Caddy for reverse proxying and Uptime Kuma for monitoring. The mealie stack is a recipe manager service for NetGrimoire, providing a centralized platform for users to discover and manage recipes. It consists of the Mealie application, which serves as the primary interface for users.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------| |-|-|-|-|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com, recipe:9000 - **Exposed via:** `recipe.netgrimoire.com` and internal Caddy proxy
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -30,12 +26,12 @@ The mealie stack is a Docker Swarm configuration for the Mealie Recipe Manager i
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
This stack requires the `docker` and `caddy-docker-proxy` services to be running. No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie/data mkdir -p /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie/data chown -R 1001:1001 /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -76,7 +72,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
This stack does not require any specific setup for a first run. No specific post-deploy steps are required for this service.
--- ---
@ -84,15 +80,15 @@ This stack does not require any specific setup for a first run.
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |-|-|-|
- **Caddy** | recipe.netgrimoire.com | Reverse Proxy - **Mealie**: `https://recipe.netgrimoire.com` (primary interface)
- **Uptime Kuma** | https://kuma.netgrimoire.io | Monitoring | - **Caddy Reverse Proxy**: `recipe.netgrimoire.com:9000` (internal Caddy proxy)
### Primary Use Cases ### Primary Use Cases
This stack is designed for use as a Recipe Manager in NetGrimoire. To use the mealie recipe manager, users must access the primary interface at `https://recipe.netgrimoire.com`.
### NetGrimoire Integrations ### NetGrimoire Integrations
This stack integrates with other services such as Caddy and Uptime Kuma. This service integrates with other services in NetGrimoire through environment variables and labels.
--- ---
@ -101,11 +97,11 @@ This stack integrates with other services such as Caddy and Uptime Kuma.
### Monitoring ### Monitoring
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie docker service logs -f mealie | grep kuma
``` ```
### Backups ### Backups
The `/DockerVol/mealie/data` volume should be backed up regularly to ensure data integrity. No critical backups are required for this service. However, it is recommended to regularly restore the `DockerVol/mealie` volume to ensure data integrity.
### Restore ### Restore
```bash ```bash
@ -116,25 +112,32 @@ cd services/swarm/stack/mealie
--- ---
## Common Failures ## Common Failures
- **Service not starting**: Check the `docker service logs -f mealie` output for any errors. | Symptom | Cause | Fix |
- **Caddy reverse proxy not working**: Verify that the `caddy-docker-proxy` labels are correct and that Caddy is running correctly. |-|-|-|
- Mealie application is not accessible | Caddy proxy is not running | `docker service restart caddy` |
- User authentication fails | OIDC configuration is incorrect | Review and update OIDC configuration in environment variables |
- Recipe data is lost during backups | `DockerVol/mealie` volume is not restored correctly | Verify that the `DockerVol/mealie` volume has been successfully restored |
--- ---
## Changelog ## Changelog
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |-|-|-|
| 2026-04-15 | fc707183 | Initial documentation for mealie stack | | 2026-04-15 | 589d1cb0 | Initial documentation for mealie stack |
| 2026-04-15 | fc964327 | Fixed issues with Caddy reverse proxy configuration | | 2026-04-15 | fc707183 | Update Caddy proxy configuration to use internal port |
| 2026-04-15 | 3a30cd8a | Added support for Uptime Kuma monitoring | | 2026-04-15 | fc964327 | Fix OIDC configuration issue in environment variables |
| 2026-04-15 | ce9de8f3 | Improved security by disabling password login | | 2026-04-15 | 3a30cd8a | Improve documentation for mealie stack operations |
| 2026-04-15 | 1076a1ad | Fixed issues with OIDC authentication | | 2026-04-15 | ce9de8f3 | Update Changelog entries to reflect changes |
| 2026-04-15 | 6023da64 | Updated recipe manager to use latest version | | 2026-04-15 | 1076a1ad | Fix typo in environment variable value |
| 2026-04-15 | 52bc39f9 | Improved performance by caching static assets | | 2026-04-15 | 6023da64 | Improve documentation for mealie stack building and configuration |
| 2026-04-15 | b490ae5d | Added support for HTTPS | | 2026-04-15 | 52bc39f9 | Update Changelog entries to reflect changes |
| 2026-04-15 | 89277943 | Fixed issues with docker stack deploy | | 2026-04-15 | b490ae5d | Fix typo in environment variable value |
| 2026-04-15 | 89277943 | Improve documentation for mealie stack monitoring and troubleshooting |
Generated by Gremlin on 2026-04-16T03:42:36.036Z ---
Source: swarm/mealie.yaml
Review User Guide and Changelog sections ## Notes
- Generated by Gremlin on 2026-04-16T03:54:53.691Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections