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 # mealie
## Overview ## 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 ## 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`
@ -29,15 +16,12 @@ The mealie stack is a Recipe Manager service for NetGrimoire. It provides featur
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
Ensure that the necessary Docker Swarm and environment variables are set. ```
### Volume Setup
```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R 1001:1001 /DockerVol/mealie chown -R user:group /DockerVol/mealie
``` ```
### Environment Variables ### Volume Setup
```bash ```bash
# generate: openssl rand -hex 32 # generate: openssl rand -hex 32
PUID=1001 PUID=1001
@ -75,7 +59,7 @@ docker stack services mealie
``` ```
### First Run ### 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 ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- **Recipe Manager** | `recipe.netgrimoire.com` | Access recipes and management interface - Caddy reverse proxy: `recipe.netgrimoire.com` (Internal only)
### Primary Use Cases ### Primary Use Cases
Use this service to manage recipes in NetGrimoire. Describe the typical use cases for this service in NetGrimoire.
### NetGrimoire Integrations ### 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 ## Operations
### Monitoring ### Monitoring
[kuma monitors from kuma.* labels]
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs mealie -f # docker service logs <service> --follow
``` ```
### Backups ### Backups
Critical: `/DockerVol/mealie` and reconstructable Critical vs reconstructable /DockerVol/ paths for backup and restore operations.
### Restore ### Restore
```bash Restore the entire stack with `./deploy.sh`.
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
| Failure Mode | Symptoms | Cause | Fix | | Symptom | 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. |
--- ---
@ -125,14 +107,14 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-16 | b46925df | Initial documentation creation | | 2026-04-16 | 6d846761 | Initial documentation and initial deployment of the mealie stack. |
| 2026-04-15 | e1f9ff52 | Updated environment variables for 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.> <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 ## Notes
- Generated by Gremlin on 2026-04-16T05:12:34.909Z Generated by Gremlin on 2026-04-16T05:16:24.090Z.
- Source: swarm/mealie.yaml Source: swarm/mealie.yaml
- Review User Guide and Changelog sections Review User Guide and Changelog sections