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 09:56:19 -05:00
parent ce338c52fb
commit ea3d7479c5
1 changed files with 29 additions and 36 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,26 +1,17 @@
---
title: mealie Stack
description: Recipe Manager
published: true
date: 2026-04-23T11:36:00.635Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-23T11:36:00.635Z
---
# mealie
## Overview
The mealie stack is a Recipe Manager service in NetGrimoire. It provides features such as recipe management and authentication.
The mealie stack is a Docker Swarm-based service that provides a recipe management system for the NetGrimoire network. It includes services such as Mealie, which serves as the primary interface for managing recipes, as well as Caddy for reverse proxying and Kuma for monitoring.
---
## Architecture
| Service | Image | Port | Role |
|---------|-------|------|------|
|-|-|-|-|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com`
- **Exposed via:** recipe.netgrimoire.com
- **Homepage group:** PNCHarris Apps
---
@ -33,14 +24,13 @@ No specific prerequisites are required for this stack.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R user:group /DockerVol/mealie
```
### Environment Variables
```bash
# generate: openssl rand -hex 32
PUID=1964
PGID=1964
PUID= $(openssl rand -hex 32)
PGID= $(openssl rand -hex 32)
TZ=America/Chicago
MAX_WORKERS=1
WEB_CONCURRENCY=1
@ -74,7 +64,7 @@ docker stack services mealie
```
### First Run
After deployment, you need to update the kuma configuration and redeploy.
No specific steps are required for this service.
---
@ -82,41 +72,40 @@ After deployment, you need to update the kuma configuration and redeploy.
### Accessing mealie
| Service | URL | Purpose |
- **Host:** `recipe.netgrimoire.com`
- **Port:** 9000
|-|-|-|
- **Mealie:** recipe.netgrimoire.com - Primary interface for managing recipes
### Primary Use Cases
To use this service in NetGrimoire, navigate to the Recipe Manager page on your dashboard and create a new recipe or manage existing ones.
Use Mealie to manage and create recipes, as well as access other features such as user management and configuration.
### NetGrimoire Integrations
This service connects to other services via OIDC authentication with authentik.
This service integrates with the following services:
- Authentik for authentication and authorization
- Caddy for reverse proxying and SSL/TLS termination
---
## Operations
### Monitoring
Kuma monitors are available for this service, providing real-time monitoring and alerting capabilities.
```bash
docker stack services mealie
<docker service logs commands>
```
### Backups
Critical backups are not available. Restores may be required if data is lost due to an error or intentional deletion.
Critical data is stored in the /DockerVol/mealie directory.
### Restore
```bash
cd services/swarm/stack/mealie
./deploy.sh
```
Restore the service by running `./deploy.sh`.
---
## Common Failures
| Symptom | Cause | Fix |
- **Failed deployment** | Insufficient disk space on docker4. | Check and increase available storage. |
- **Login issues** | Incorrect credentials or authentication configuration error. | Verify that the OIDC configuration is correct and redeploy if necessary. |
- **Recipe not saved** | Data write failure due to permissions issue. | Check the file system permissions for the Docker volume and ensure they are set correctly. |
|-|-|-|
- No response from Mealie interface. | Mealie instance not started. | docker stack services mealie --watch`
- Authentication issues with Authentik. | Authentik instance not configured correctly. | Review and correct Authentik configuration`
---
@ -124,10 +113,14 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-23 | 9d75346d | Initial documentation |
| 2026-04-22 | ce657f97 | |
| 2026-04-22 | 85531b16 | |
| 2026-04-21 | a942ffb9 | |
| 2026-04-21 | fdd16eff | |
| 2026-04-23 | 9d01998f | Initial documentation creation |
| 2026-04-23 | 9d75346d | Documentation updates for service features and functionality |
<Write a paragraph summarizing the evolution of this service based on the diffs above. Since no diffs are available, note that this is the initial documentation.>
---
## Notes
- Generated by Gremlin on 2026-04-23T14:54:26.605Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections