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-29 14:55:22 -05:00
parent 364a92eb3a
commit f7247bdf3e
1 changed files with 24 additions and 28 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,27 +1,24 @@
--- ---
title: mealie Stack title: mealie Stack
description: Mealie recipe management platform in NetGrimoire description: Recipe Manager
published: true published: true
date: 2026-04-28T20:04:22.946Z date: 2026-04-29T19:53:28.323Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-28T20:04:22.946Z dateCreated: 2026-04-29T19:53:28.323Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie Stack provides a recipe management platform in NetGrimoire, enabling users to manage and share recipes across the community. It is composed of a single service that runs on docker4, utilizing the netgrimoire overlay network. The mealie stack is a Docker Swarm-based application that serves as the recipe manager in NetGrimoire. It provides a web interface for managing recipes and allows users to access them through the netgrimoire overlay network.
---
## 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:9000
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -29,12 +26,12 @@ The mealie Stack provides a recipe management platform in NetGrimoire, enabling
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
Ensure Docker and Caddy are installed on the cluster. No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R docker4:docker4 /DockerVol/mealie chown -R 1964:1964 /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -75,7 +72,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
After initial deployment, the service should be accessible at recipe.netgrimoire.com. Users can log in with their credentials and start managing recipes. Run the `./deploy.sh` script after initial deployment.
--- ---
@ -84,30 +81,29 @@ After initial deployment, the service should be accessible at recipe.netgrimoire
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- **mealie** | https://recipe.netgrimoire.com | Recipe Management Platform | - **recipe:** https://recipe.netgrimoire.com
### Primary Use Cases ### Primary Use Cases
To use this service, users should be familiar with recipe management platforms. They can create and share recipes, manage their own profiles, and engage with the community. Use the recipe manager to manage recipes in NetGrimoire.
### NetGrimoire Integrations ### NetGrimoire Integrations
This service integrates with other services in NetGrimoire, such as authentik for user authentication and monitoring tools like Uptime Kuma to ensure platform availability. The mealie stack integrates with other services, such as authentik, through OIDC authentication.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
- `kuma.*`: Ensure Uptime Kuma is installed on the cluster. [kuma monitors from kuma.* labels]
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie docker service logs -f mealie
``` ```
### Backups ### Backups
Critical data stored in /DockerVol/mealie. Regular backups are essential to ensure business continuity. Critical: `/DockerVol/mealie` is critical for data integrity. Reconstructable: no explicit backup instructions are provided.
### Restore ### Restore
To restore the service, re-run the deploy script.
```bash ```bash
cd services/swarm/stack/mealie cd services/swarm/stack/mealie
./deploy.sh ./deploy.sh
@ -116,11 +112,10 @@ cd services/swarm/stack/mealie
--- ---
## Common Failures ## Common Failures
| Failure Mode | Symptoms | Cause | Fix | | Symptom | Cause | Fix |
|-------------|----------|------|-----| |---------|-------|-----|
| 1. Service Not Accessible | Error message when accessing recipe.netgrimoire.com | Caddy configuration issue or Docker service not running | Check caddy logs and ensure the Docker service is up and running | - Service not responding | Insufficient resources | Scale service to increase resources |
| 2. User Authentication Issues | Unable to log in with credentials | OIDC configuration issue or Authentik integration problem | Review OIDC configuration and verify Authentik connection | - Authentication issues | OIDC configuration issues | Check OIDC client ID and secret, ensure correct configuration |
| 3. Service Not Deploying | Error message during deploy process | Docker swarm configuration issue or service not found | Check docker stack config file for errors and ensure the service exists in the swarm |
--- ---
@ -128,14 +123,15 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-28 | f62e2f0b | Initial deployment of mealie Stack in NetGrimoire | | 2026-04-29 | 78a2ca11 | Initial documentation and setup |
| 2026-04-28 | 1637c0bd | Fixed issue with recipe.netgrimoire.com accessibility | | 2026-04-28 | f62e2f0b | |
| 2026-04-28 | 1637c0bd | |
<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.> | 2026-04-28 | f7186f36 | |
| 2026-04-28 | afa15f18 | |
--- ---
## Notes ## Notes
- Generated by Gremlin on 2026-04-28T20:04:22.946Z - Generated by Gremlin on 2026-04-29T19:53:28.323Z
- Source: swarm/mealie.yaml - Source: swarm/mealie.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections