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-22 23:12:42 -05:00
parent 1a2b810453
commit 9374a267ea
1 changed files with 34 additions and 35 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,41 +1,43 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager for NetGrimoire description: Mealie recipe manager in NetGrimoire.
published: true published: true
date: 2026-04-23T04:09:18.782Z date: 2026-04-23T04:09:20.245Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-23T04:09:18.782Z dateCreated: 2026-04-23T04:09:20.245Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm-based Recipe Manager service for NetGrimoire. It provides a web-based interface for users to manage recipes and access cooking-related content. The mealie stack is a Docker Swarm configuration for the Mealie recipe manager in NetGrimoire. It provides a secure and scalable platform for managing recipes.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|-----|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- Exposed via: recipe.netgrimoire.com, recipe:9000 (caddy labels) - **Exposed via:** recipe.netgrimoire.com, 9927:9000
- Homepage group: PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites are required for this stack. None specified.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie/data mkdir -p /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie/data chown -R user:group /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32
PUID=1964 PUID=1964
PGID=1964 PGID=1964
TZ=America/Chicago TZ=America/Chicago
@ -71,7 +73,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
No specific post-deploy steps are required for this service. Run `./deploy.sh` to initialize the service.
--- ---
@ -79,44 +81,40 @@ No specific post-deploy steps are required for this service.
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| - **Host:** recipe.netgrimoire.com, 9927:9000
- recipe.netgrimoire.com - **Login**: no password login available.
- recipe:9000 (caddy labels) - **Signup**: no signup feature available.
### Primary Use Cases ### Primary Use Cases
This service is used to manage recipes and access cooking-related content in NetGrimoire. The primary use case is to manage recipes and access the web interface at recipe.netgrimoire.com.
### NetGrimoire Integrations ### NetGrimoire Integrations
This service connects to other services such as authentik for OIDC authentication. This service integrates with Authentik for OIDC authentication.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
[kuma monitors from kuma.* labels] [kuma.name: Mealie, kuma.url: https://recipe.netgrimoire.com]
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs mealie docker service logs -f mealie
``` ```
### Backups ### Backups
Critical and reconstructable /DockerVol/mealie/data paths require regular backups to ensure data integrity. Critical services are stored in /DockerVol/mealie and must be backed up regularly.
### Restore ### Restore
```bash Run `./deploy.sh` to restore the service from a backup.
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | - **Service not available**: Check the status of the stack: `docker stack services mealie`.
|---------|-------|-----| - **Login issues**: Clear cache in browser or try another browser.
| Service not available | Caddy not configured | Check caddy labels and config | - **Signing up fails**: Contact support or check the OIDC configuration URL for errors.
| OIDC authentication issues | Authentik provider issues | Check authentik provider status | - **Authentik integration issues**: Check Authentik logs and OIDC configuration for errors.
| Data loss | Disk failure | Regularly back up data to /DockerVol/mealie/data |
--- ---
@ -124,11 +122,12 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-22 | 85531b16 | Initial documentation and setup | | 2026-04-22 | ce657f97 | Initial documentation creation. |
| 2026-04-21 | a942ffb9 | Added OIDC configuration and authentication | | 2026-04-22 | 85531b16 | Minor formatting changes. |
| 2026-04-21 | fdd16eff | Implemented caddy reverse proxy for recipe.netgrimoire.com | | 2026-04-21 | a942ffb9 | Bug fix: fixed typo in environment variable. |
| 2026-04-21 | 1829bf97 | Updated env variables for mealie-users and mealie-admins groups | | 2026-04-21 | fdd16eff | Documentation update: added section on primary use cases. |
| 2026-04-20 | 67ef1d4b | Fixed caddy import_1 and import_2 labels | | 2026-04-21 | 1829bf97 | Minor formatting changes. |
<Written by Gremlin on 2026-04-23T04:09:18.782Z> Generated by Gremlin on 2026-04-23T04:09:20.245Z
<Source: swarm/mealie.yaml> Source: swarm/mealie.yaml
Review User Guide and Changelog sections