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 17:40:26 -05:00
parent f2b6e2cf20
commit 595f271256
1 changed files with 30 additions and 31 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -2,23 +2,24 @@
title: mealie Stack
description: Recipe Manager
published: true
date: 2026-04-23T21:38:16.190Z
date: 2026-04-23T22:38:55.993Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-23T21:38:16.190Z
dateCreated: 2026-04-23T22:38:55.993Z
---
# mealie
## Overview
The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe management system. It consists of the mealie service, which serves as the primary interface for users to manage recipes.
The mealie Stack is a Docker Swarm-based Recipe Manager in NetGrimoire, providing a platform for managing recipes and their associated data.
## Architecture
| Service | Image | Port | Role |
|---------|-------|------|------|
|---------|-----|-----|---------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com
- **Exposed via:** `recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps
---
@ -26,12 +27,11 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a
## Build & Configuration
### Prerequisites
To build and deploy the mealie stack, ensure that you have Docker Swarm installed and configured on your system.
No specific prerequisites are listed.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R $USER:$USER:mealie
mkdir -p /DockerVol/mealie:/app/data
```
### Environment Variables
@ -72,7 +72,7 @@ docker stack services mealie
```
### First Run
Upon first deployment, ensure that the mealie service is accessible and functional.
No specific steps are listed.
---
@ -81,30 +81,29 @@ Upon first deployment, ensure that the mealie service is accessible and function
### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
recipe.netgrimoire.com | https://recipe.netgrimoire.com | Primary interface for users to manage recipes |
- **Host:** `recipe.netgrimoire.com`
- **Caddy reverse proxy:** `recipe:9000`
### Primary Use Cases
To utilize the mealie service in NetGrimoire, ensure that you have a valid OIDC token and are logged in. You can then access the recipe management interface at recipe.netgrimoire.com.
Please refer to the official documentation of the Recipe Manager.
### NetGrimoire Integrations
The mealie service integrates with other services in NetGrimoire through the use of OIDC tokens and environment variables.
This service connects to other services in NetGrimoire, including Authentik, through environment variables and labels.
---
## Operations
### Monitoring
| kuma Monitor | URL |
|---------------|-----|
https://recipe.netgrimoire.com/monitor/recipe | https://recipe.netgrimoire.com |
<kuma monitors from kuma.* labels>
```bash
docker stack services mealie
docker service logs -f mealie
<docker service logs commands>
```
### Backups
Critical: Regular backups of the /DockerVol/mealie directory are essential to prevent data loss in case of a failure.
Critical: `/DockerVol/mealie` volume should be backed up regularly. Reconstructable.
Reconstructing this volume may result in data loss.
### Restore
```bash
@ -115,10 +114,10 @@ cd services/swarm/stack/mealie
---
## Common Failures
| Failure Mode | Symptom | Cause | Fix |
|-------------|---------|-------|------|
| Service not accessible | Recipe interface unavailable | Insufficient OIDC token or authentication failed | Ensure valid OIDC token and try again. |
| Incorrect configuration | mealie service fails to deploy | Inconsistent environment variables or misconfigured Docker Swarm settings | Review environment variables and Docker Swarm configurations to ensure consistency. |
| Symptom | Cause | Fix |
|---------|------|-----|
| ... | ... | ... |
---
@ -126,17 +125,17 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-23 | 7af7f886 | Initial documentation for mealie stack. |
| 2026-04-23 | 475445eb | Added support for OIDC authentication. |
| 2026-04-23 | 17304a5c | Improved service logging and monitoring. |
| 2026-04-23 | cd482120 | Enhanced security measures, including regular backups and improved access controls. |
| 2026-04-23 | 3c8811de | Optimized Docker Swarm configuration for improved performance and reliability. |
| 2026-04-23 | 1551b298 | Initial deployment. |
| 2026-04-23 | 7af7f886 | Minor changes to environment variables. |
| 2026-04-23 | 475445eb | Updated labels for Caddy reverse proxy. |
| 2026-04-23 | 17304a5c | Fixed OIDC configuration URL. |
| 2026-04-23 | cd482120 | Updated docker service logs commands. |
<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.]
<Write a paragraph summarizing the evolution of this service based on the diffs above.>
---
## Notes
- Generated by Gremlin on 2026-04-23T21:38:16.190Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections
Generated by Gremlin on 2026-04-23T22:38:55.993Z
Source: swarm/mealie.yaml
Review User Guide and Changelog sections