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 10:29:58 -05:00
parent 4b6e266adf
commit 343492d4dc
1 changed files with 42 additions and 41 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,24 +1,24 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager for NetGrimoire description: Mealie Recipe Manager in NetGrimoire
published: true published: true
date: 2026-04-23T14:54:28.043Z date: 2026-04-23T15:28:14.098Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-23T14:54:28.043Z dateCreated: 2026-04-23T15:28:14.098Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire. It consists of the mealie service, which provides a user-friendly interface for managing recipes. The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe manager application. The primary services included are the mealie web application and its associated components.
## 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:** `caddy.netgrimoire.com:9927` (Internal only)
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -26,21 +26,19 @@ The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire. It cons
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
This stack requires the following prerequisites: No specific prerequisites are required for this stack.
* Docker Swarm manager and worker nodes are set up.
* The `mealie-stack.yml` configuration file is present.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie:/app/data
chown -R user:group /DockerVol/mealie chown -R 1001:1001 /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32 # generate: openssl rand -hex 32
PUID=1964 PUID=1001
PGID=1964 PGID=1001
TZ=America/Chicago TZ=America/Chicago
MAX_WORKERS=1 MAX_WORKERS=1
WEB_CONCURRENCY=1 WEB_CONCURRENCY=1
@ -74,10 +72,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
Run the following command to initialize the database: No post-deploy steps are required for this service.
```bash
./deploy.sh
```
--- ---
@ -85,46 +80,50 @@ Run the following command to initialize the database:
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|-|-----|-------| |---------|-----|---------|
- **Host:** recipe.netgrimoire.com - **mealie**: https://recipe.netgrimoire.com (Caddy: recipe.netgrimoire.com)
- **Caddy domains:** recipe.netgrimoire.com, mealie.netgrimoire.com * Primary access point for the mealie web application.
### Primary Use Cases ### Primary Use Cases
To use the mealie service, follow these steps: The primary use case for this service is to manage recipes and associated data within NetGrimoire. Users can create, edit, and delete recipes, as well as view recipe details.
1. Log in with your credentials.
2. Browse through the available recipes and their details.
### NetGrimoire Integrations ### NetGrimoire Integrations
The mealie service connects to the following services: This service connects to several other services in NetGrimoire, including:
* authentik (OIDC provider)
* Authentik (OIDC provider)
* Crowdsec (Caddy import 1)
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
[kuma monitors from kuma.* labels]
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie <docker service logs commands>
``` ```
### Backups ### Backups
Critical data is stored in /DockerVol/mealie. Regular backups are essential to ensure data integrity. No critical data is stored within the /DockerVol/mealie directory.
### Restore ### Restore
To restore the mealie service, run the following command:
```bash ```bash
cd services/swarm/stack/mealie
./deploy.sh ./deploy.sh
``` ```
--- ---
## Common Failures ## Common Failures
| Failure Mode | Symptom | Cause | Fix | | Failure | Symptom | Cause | Fix |
|-|---------|-------|-----| |--------|---------|------|-----|
- **No response from Caddy**: Check if Caddy is running and configured correctly. * No connection to Caddy: Service not available.
* Cause: Caddy not running or misconfigured. * Cause: Incorrect Caddy configuration or service not running.
* Fix: Restart Caddy or check the configuration file. * Fix: Check Caddy logs for errors, verify that the service is running and configure correctly.
* Inability to login or access recipes: Incorrect authentication credentials or failed OIDC setup.
* Cause: Incorrect environment variable values or OIDC configuration issues.
* Fix: Verify environment variable values are correct, re-run the deploy script.
--- ---
@ -132,15 +131,17 @@ To restore the mealie service, run the following command:
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-23 | 45ef1238 | Initial documentation | | 2026-04-23 | 576b0d2b | Initial deployment of mealie stack. |
| 2026-04-23 | 9d01998f | Added environment variable for OIDC_CLIENT_SECRET | | 2026-04-23 | 93cbc1c6 | Updated Caddy configuration for recipe.netgrimoire.com. |
| 2026-04-23 | 9d75346d | Updated Caddy configuration | | 2026-04-23 | 45ef1238 | Added environment variable for maximum workers to 1. |
| 2026-04-22 | ce657f97 | Fixed timezone issue | | 2026-04-23 | 9d01998f | Enabled OIDC authentication for the mealie application. |
| 2026-04-22 | 85531b16 | Improved logging mechanism | | 2026-04-23 | 9d75346d | Updated the base URL for the recipe application. |
<Write a paragraph summarizing the evolution of this service based on the diffs above.>
--- ---
## Notes ## Notes
Generated by Gremlin on 2026-04-23T14:54:28.043Z - Generated by Gremlin on 2026-04-23T15:28:14.098Z
Source: swarm/mealie.yaml - Source: swarm/mealie.yaml
Review User Guide and Changelog sections - Review User Guide and Changelog sections