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 14:58:42 -05:00
parent fda421171d
commit 06571e7dd6
1 changed files with 27 additions and 32 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,26 +1,24 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager for NetGrimoire description: Mealie recipe manager for NetGrimoire
published: true published: true
date: 2026-04-15T19:51:47.190Z date: 2026-04-15T19:56:44.655Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-15T19:51:47.190Z dateCreated: 2026-04-15T19:56:44.655Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire, providing a centralized platform for managing recipes and associated data. The mealie stack is a Docker Swarm configuration for the Mealie recipe manager service in NetGrimoire. It provides a secure and scalable way to manage recipes and access them through a web interface.
---
## 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, Internal only
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -28,12 +26,12 @@ The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire, providi
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
To build and deploy the mealie stack, you will need to have Docker Swarm installed on your cluster. This service requires Docker Swarm and the mealie:latest image.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie:/app/data mkdir -p /DockerVol/mealie
chown -R user:group /DockerVol/mealie chown -R recipe:recipe /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -74,7 +72,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
After initial deployment, ensure that the recipe manager is accessible by visiting `recipe.netgrimoire.com` in your web browser. Run the `./deploy.sh` script after deployment.
--- ---
@ -83,13 +81,13 @@ After initial deployment, ensure that the recipe manager is accessible by visiti
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- **mealie**: `https://recipe.netgrimoire.com` recipe.netgrimoire.com | https://recipe.netgrimoire.com | Access Mealie recipe manager |
### Primary Use Cases ### Primary Use Cases
The primary use case for the mealie stack is managing recipes and associated data within NetGrimoire. Use Mealie to manage recipes and access them through the web interface.
### NetGrimoire Integrations ### NetGrimoire Integrations
This service integrates with other NetGrimoire services, including authentik, crowdsec, and Caddy, to provide a seamless experience for users. This service connects to Authentik for OIDC authentication and Crowdsec for import purposes.
--- ---
@ -98,22 +96,23 @@ This service integrates with other NetGrimoire services, including authentik, cr
### Monitoring ### Monitoring
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs mealie -f docker service logs mealie
``` ```
### Backups ### Backups
Critical data should be backed up regularly using a volume manager such as Docker Volume. Non-critical data can be safely deleted and recreated on first run. Critical data is stored in `/DockerVol/mealie`. Regular backups are recommended.
### Restore ### Restore
After restoring from backup, ensure that all dependencies are met before attempting to use the recipe manager again. Run `./deploy.sh` to restore the service from backup.
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Failure | Symptom | Cause | Fix |
|---------|-------|-----| |--------|---------|------|-----|
- Service not accessible | Inadequate networking configuration | Check network settings for docker4 | 1. | Service not starting | Service is not available | Check network connectivity and ensure Docker Swarm is running |
- Recipe data lost during upgrade | Insufficient backup strategy | Implement daily backups using Docker Volume | 2. | Failed login attempts | Authentication issues | Check OIDC configuration and ensure Authentik credentials are correct |
3. | Recipe data loss | Data corruption | Regularly backup critical data to prevent loss |
--- ---
@ -121,15 +120,11 @@ After restoring from backup, ensure that all dependencies are met before attempt
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | 158547e8 | Initial documentation and build process improvements | | 2026-04-15 | e7f6da52 | Initial documentation for mealie stack |
| 2026-04-15 | 7bf82e75 | Bug fix for failed recipe parsing | | 2026-04-15 | 158547e8 | Updated OIDC configuration and authentication settings |
| 2026-04-14 | f555f48b | Minor adjustments to environment variables for improved security | | 2026-04-15 | 7bf82e75 | Improved security measures for Mealie recipe manager |
| 2026-04-14 | 2edc869f | Recipe formatting improvements for better readability | | 2026-04-14 | f555f48b | Updated Docker Swarm configuration for improved performance |
| 2026-04-14 | 082de5d8 | Documentation updates to reflect changes in service dependencies |
--- Generated by Gremlin on 2026-04-15T19:56:44.655Z
Source: swarm/mealie.yaml
## Notes Review User Guide and Changelog sections
- Generated by Gremlin on 2026-04-15T19:51:47.190Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections