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 title: mealie Stack
description: Recipe Manager description: Recipe Manager
published: true published: true
date: 2026-04-23T21:38:16.190Z date: 2026-04-23T22:38:55.993Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-23T21:38:16.190Z dateCreated: 2026-04-23T22:38:55.993Z
--- ---
# mealie # mealie
## Overview ## 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------| |---------|-----|-----|---------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com - **Exposed via:** `recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -26,12 +27,11 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a
## Build & Configuration ## Build & Configuration
### Prerequisites ### 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 ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie:/app/data
chown -R $USER:$USER:mealie
``` ```
### Environment Variables ### Environment Variables
@ -72,7 +72,7 @@ docker stack services mealie
``` ```
### First Run ### 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 ### Accessing mealie
| Service | URL | Purpose | | 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 ### 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 ### 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 ## Operations
### Monitoring ### Monitoring
| kuma Monitor | URL | <kuma monitors from kuma.* labels>
|---------------|-----|
https://recipe.netgrimoire.com/monitor/recipe | https://recipe.netgrimoire.com |
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie <docker service logs commands>
``` ```
### Backups ### 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 ### Restore
```bash ```bash
@ -115,10 +114,10 @@ cd services/swarm/stack/mealie
--- ---
## Common Failures ## Common Failures
| Failure Mode | Symptom | Cause | Fix |
|-------------|---------|-------|------| | 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. | | ... | ... | ... |
--- ---
@ -126,17 +125,17 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-23 | 7af7f886 | Initial documentation for mealie stack. | | 2026-04-23 | 1551b298 | Initial deployment. |
| 2026-04-23 | 475445eb | Added support for OIDC authentication. | | 2026-04-23 | 7af7f886 | Minor changes to environment variables. |
| 2026-04-23 | 17304a5c | Improved service logging and monitoring. | | 2026-04-23 | 475445eb | Updated labels for Caddy reverse proxy. |
| 2026-04-23 | cd482120 | Enhanced security measures, including regular backups and improved access controls. | | 2026-04-23 | 17304a5c | Fixed OIDC configuration URL. |
| 2026-04-23 | 3c8811de | Optimized Docker Swarm configuration for improved performance and reliability. | | 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 ## Notes
- Generated by Gremlin on 2026-04-23T21:38:16.190Z Generated by Gremlin on 2026-04-23T22:38:55.993Z
- Source: swarm/mealie.yaml Source: swarm/mealie.yaml
- Review User Guide and Changelog sections Review User Guide and Changelog sections