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
description: Recipe Manager for NetGrimoire
description: Mealie recipe manager for NetGrimoire
published: true
date: 2026-04-15T19:51:47.190Z
date: 2026-04-15T19:56:44.655Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-15T19:51:47.190Z
dateCreated: 2026-04-15T19:56:44.655Z
---
# mealie
## 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
| Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com`
- **Exposed via:** recipe.netgrimoire.com, Internal only
- **Homepage group:** PNCHarris Apps
---
@ -28,12 +26,12 @@ The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire, providi
## Build & Configuration
### 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
```bash
mkdir -p /DockerVol/mealie:/app/data
chown -R user:group /DockerVol/mealie
mkdir -p /DockerVol/mealie
chown -R recipe:recipe /DockerVol/mealie
```
### Environment Variables
@ -74,7 +72,7 @@ docker stack services mealie
```
### 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
| Service | URL | Purpose |
|---------|-----|---------|
- **mealie**: `https://recipe.netgrimoire.com`
recipe.netgrimoire.com | https://recipe.netgrimoire.com | Access Mealie recipe manager |
### 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
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
```bash
docker stack services mealie
docker service logs mealie -f
docker service logs mealie
```
### 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
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
| Symptom | Cause | Fix |
|---------|-------|-----|
- Service not accessible | Inadequate networking configuration | Check network settings for docker4 |
- Recipe data lost during upgrade | Insufficient backup strategy | Implement daily backups using Docker Volume |
| Failure | Symptom | Cause | Fix |
|--------|---------|------|-----|
1. | Service not starting | Service is not available | Check network connectivity and ensure Docker Swarm is running |
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 |
|------|--------|---------|
| 2026-04-15 | 158547e8 | Initial documentation and build process improvements |
| 2026-04-15 | 7bf82e75 | Bug fix for failed recipe parsing |
| 2026-04-14 | f555f48b | Minor adjustments to environment variables for improved security |
| 2026-04-14 | 2edc869f | Recipe formatting improvements for better readability |
| 2026-04-14 | 082de5d8 | Documentation updates to reflect changes in service dependencies |
| 2026-04-15 | e7f6da52 | Initial documentation for mealie stack |
| 2026-04-15 | 158547e8 | Updated OIDC configuration and authentication settings |
| 2026-04-15 | 7bf82e75 | Improved security measures for Mealie recipe manager |
| 2026-04-14 | f555f48b | Updated Docker Swarm configuration for improved performance |
---
## Notes
- Generated by Gremlin on 2026-04-15T19:51:47.190Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections
Generated by Gremlin on 2026-04-15T19:56:44.655Z
Source: swarm/mealie.yaml
Review User Guide and Changelog sections