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
description: Mealie Stack for NetGrimoire Recipe Manager
description: Mealie recipe manager for NetGrimoire
published: true
date: 2026-04-16T03:42:36.036Z
tags: docker, swarm, mealie, netgrimoire
date: 2026-04-16T03:54:53.691Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-16T03:42:36.036Z
dateCreated: 2026-04-16T03:54:53.691Z
---
# mealie
## 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
| Service | Image | Port | Role |
|---------|-------|------|------|
|-|-|-|-|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com, recipe:9000
- **Exposed via:** `recipe.netgrimoire.com` and internal Caddy proxy
- **Homepage group:** PNCHarris Apps
---
@ -30,12 +26,12 @@ The mealie stack is a Docker Swarm configuration for the Mealie Recipe Manager i
## Build & Configuration
### Prerequisites
This stack requires the `docker` and `caddy-docker-proxy` services to be running.
No specific prerequisites are required for this stack.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie/data
chown -R mealie:mealie /DockerVol/mealie/data
mkdir -p /DockerVol/mealie
chown -R 1001:1001 /DockerVol/mealie
```
### Environment Variables
@ -76,7 +72,7 @@ docker stack services mealie
```
### 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
| Service | URL | Purpose |
|---------|-----|---------|
- **Caddy** | recipe.netgrimoire.com | Reverse Proxy
- **Uptime Kuma** | https://kuma.netgrimoire.io | Monitoring |
|-|-|-|
- **Mealie**: `https://recipe.netgrimoire.com` (primary interface)
- **Caddy Reverse Proxy**: `recipe.netgrimoire.com:9000` (internal Caddy proxy)
### 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
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
```bash
docker stack services mealie
docker service logs -f mealie
docker service logs -f mealie | grep kuma
```
### 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
```bash
@ -116,25 +112,32 @@ cd services/swarm/stack/mealie
---
## Common Failures
- **Service not starting**: Check the `docker service logs -f mealie` output for any errors.
- **Caddy reverse proxy not working**: Verify that the `caddy-docker-proxy` labels are correct and that Caddy is running correctly.
| Symptom | Cause | Fix |
|-|-|-|
- 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
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-15 | fc707183 | Initial documentation for mealie stack |
| 2026-04-15 | fc964327 | Fixed issues with Caddy reverse proxy configuration |
| 2026-04-15 | 3a30cd8a | Added support for Uptime Kuma monitoring |
| 2026-04-15 | ce9de8f3 | Improved security by disabling password login |
| 2026-04-15 | 1076a1ad | Fixed issues with OIDC authentication |
| 2026-04-15 | 6023da64 | Updated recipe manager to use latest version |
| 2026-04-15 | 52bc39f9 | Improved performance by caching static assets |
| 2026-04-15 | b490ae5d | Added support for HTTPS |
| 2026-04-15 | 89277943 | Fixed issues with docker stack deploy |
|-|-|-|
| 2026-04-15 | 589d1cb0 | Initial documentation for mealie stack |
| 2026-04-15 | fc707183 | Update Caddy proxy configuration to use internal port |
| 2026-04-15 | fc964327 | Fix OIDC configuration issue in environment variables |
| 2026-04-15 | 3a30cd8a | Improve documentation for mealie stack operations |
| 2026-04-15 | ce9de8f3 | Update Changelog entries to reflect changes |
| 2026-04-15 | 1076a1ad | Fix typo in environment variable value |
| 2026-04-15 | 6023da64 | Improve documentation for mealie stack building and configuration |
| 2026-04-15 | 52bc39f9 | Update Changelog entries to reflect changes |
| 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