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-15 18:15:45 -05:00
parent 2e19a1fe17
commit af2635a610
1 changed files with 57 additions and 18 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,26 +1,23 @@
---
title: mealie Stack
description: Recipe Manager
description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-15T23:07:29.519Z
date: 2026-04-15T23:13:44.661Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-15T23:07:29.519Z
dateCreated: 2026-04-15T23:13:44.661Z
---
# mealie
## Overview
The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It includes the mealie service, which provides a web interface for managing recipes.
---
The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe manager service in NetGrimoire. It provides a centralized 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`, `caddy:9000`
- **Homepage group:** PNCHarris Apps
---
@ -28,11 +25,12 @@ The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It inclu
## Build & Configuration
### Prerequisites
To deploy the mealie stack, you need to have Docker Swarm and Caddy installed.
No specific prerequisites are required for this stack.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie:/app/data
mkdir -p /DockerVol/mealie
chown -R docker4:docker4 /DockerVol/mealie
```
### Environment Variables
@ -73,10 +71,7 @@ docker stack services mealie
```
### First Run
After the initial deployment, you need to run the following command to initialize the database:
```bash
./init.sh
```
This service does not require any specific setup after deployment.
---
@ -84,11 +79,55 @@ After the initial deployment, you need to run the following command to initializ
### Accessing mealie
| Service | URL | Purpose |
- **Host:** `recipe.netgrimoire.com`
- **Port:** 9000 (internal) or `recipe.netgrimoire.com` (external)
- **Recipe Manager:** `https://recipe.netgrimoire.com`
- **Caddy Proxy:** `caddy:9000`
### Primary Use Cases
To use the mealie service, you need to sign up for an account and access the web interface.
To manage recipes and their associated data, navigate to the Recipe Manager service.
### NetGrimoire Integrations
The mealie service connects to other services in NetGrimoire through environment variables and labels.
The mealie stack integrates with Authentik for OIDC authentication.
---
## Operations
### Monitoring
```bash
docker stack services mealie
docker service logs -f mealie
```
### Backups
Critical data should be backed up on the `/DockerVol/mealie` volume.
### Restore
To restore from a backup, redeploy the `mealie-stack.yml` file using `./deploy.sh`.
---
## Common Failures
- **Symptom:** Mealie fails to start.
- **Cause:** Insecure environment variables or Docker image issues.
- **Fix:** Review and update environment variables and Docker images.
---
## Changelog
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-15 | b9007e9e | Initial documentation. |
| 2026-04-15 | 58549b2e | Added Caddy reverse proxy configuration. |
| 2026-04-15 | e79fb0ad | Updated OIDC client ID and secret. |
| 2026-04-15 | d2d9ac52 | Improved Docker volume setup security. |
| 2026-04-15 | e7979588 | Enhanced NetGrimoire integration with Authentik. |
<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.>
---
## Notes
- Generated by Gremlin on 2026-04-15T23:13:44.661Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections