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-16 00:19:11 -05:00
parent dbf56dc120
commit 36eee9423b
1 changed files with 22 additions and 40 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,24 +1,11 @@
---
title: mealie Stack
description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-16T05:12:34.909Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-16T05:12:34.909Z
---
# mealie
## Overview
The mealie stack is a Recipe Manager service for NetGrimoire. It provides features such as recipe listing and management.
---
The mealie stack is a Docker Swarm-based service in NetGrimoire that provides a recipe manager for users. It exposes the Mealie frontend at `https://recipe.netgrimoire.com` and acts as a reverse proxy, Caddy configuration indicates that it listens on `9000`, which aligns with this.
## Architecture
| Service | Image | Port | Role |
|---------|-----|-----|------|
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com`
@ -29,15 +16,12 @@ The mealie stack is a Recipe Manager service for NetGrimoire. It provides featur
## Build & Configuration
### Prerequisites
Ensure that the necessary Docker Swarm and environment variables are set.
### Volume Setup
```bash
```
mkdir -p /DockerVol/mealie
chown -R 1001:1001 /DockerVol/mealie
chown -R user:group /DockerVol/mealie
```
### Environment Variables
### Volume Setup
```bash
# generate: openssl rand -hex 32
PUID=1001
@ -75,7 +59,7 @@ docker stack services mealie
```
### First Run
After the initial deployment, verify that the service is accessible and running.
Set up any necessary dependencies or configurations after deployment.
---
@ -84,40 +68,38 @@ After the initial deployment, verify that the service is accessible and running.
### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
- **Recipe Manager** | `recipe.netgrimoire.com` | Access recipes and management interface
- Caddy reverse proxy: `recipe.netgrimoire.com` (Internal only)
### Primary Use Cases
Use this service to manage recipes in NetGrimoire.
Describe the typical use cases for this service in NetGrimoire.
### NetGrimoire Integrations
This service integrates with authentik for OAuth authentication.
List any other services or integrations that mealie connects to, such as authentication providers or other recipes.
---
## Operations
### Monitoring
[kuma monitors from kuma.* labels]
```bash
docker stack services mealie
docker service logs mealie -f
# docker service logs <service> --follow
```
### Backups
Critical: `/DockerVol/mealie` and reconstructable
Critical vs reconstructable /DockerVol/ paths for backup and restore operations.
### Restore
```bash
cd services/swarm/stack/mealie
./deploy.sh
```
Restore the entire stack with `./deploy.sh`.
---
## Common Failures
| Failure Mode | Symptoms | Cause | Fix |
|-------------|----------|------|-----|
- Inaccessible service | Service not responding | Incorrect environment variables or configuration issues | Check and correct environment variables and ensure proper Docker Swarm setup. |
- Unauthorized access | Unable to log in with credentials | Incorrect authentication settings | Review and update the OAuth configuration and client IDs. |
| Symptom | Cause | Fix |
|---------|-------|-----|
| | | |
---
@ -125,14 +107,14 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-16 | b46925df | Initial documentation creation |
| 2026-04-15 | e1f9ff52 | Updated environment variables for mealie stack |
| 2026-04-16 | 6d846761 | Initial documentation and initial deployment of the mealie stack. |
| 2026-04-15 | e1f9ff52 | <inferred change> |
<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-16T05:12:34.909Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections
Generated by Gremlin on 2026-04-16T05:16:24.090Z.
Source: swarm/mealie.yaml
Review User Guide and Changelog sections