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 18:29:49 -05:00
parent af2635a610
commit 5d7d8f289b
1 changed files with 34 additions and 29 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,23 +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-15T23:13:44.661Z date: 2026-04-15T23:27:38.111Z
tags: docker,swarm,mealie,netgrimoire tags: docker, swarm, mealie, netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-15T23:13:44.661Z dateCreated: 2026-04-15T23:27:38.111Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and their associated data. The mealie stack is a recipe manager service in NetGrimoire, providing a central hub for users to discover and access recipes.
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com`, `caddy:9000` - **Exposed via:** recipe.netgrimoire.com
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -25,17 +26,16 @@ The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe ma
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites are required for this stack. None specified.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R docker4:docker4 /DockerVol/mealie chown -R mealie:mealie /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32
PUID=1001 PUID=1001
PGID=998 PGID=998
TZ=America/Chicago TZ=America/Chicago
@ -71,7 +71,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
This service does not require any specific setup after deployment. Run `./deploy.sh` after the initial deployment to complete any necessary setup.
--- ---
@ -79,37 +79,42 @@ This service does not require any specific setup after deployment.
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
- **Recipe Manager:** `https://recipe.netgrimoire.com` - **Recipe**: recipe.netgrimoire.com
- **Caddy Proxy:** `caddy:9000`
### Primary Use Cases ### Primary Use Cases
To manage recipes and their associated data, navigate to the Recipe Manager service. Use mealie as a central hub for discovering and accessing recipes in NetGrimoire.
### NetGrimoire Integrations ### NetGrimoire Integrations
The mealie stack integrates with Authentik for OIDC authentication. mealie integrates with other services, including authentik for OIDC authentication.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
[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 should be backed up on the `/DockerVol/mealie` volume. Critical data should be backed up to a separate volume. Reconstructing from backup is not recommended due to the potential loss of data.
### Restore ### Restore
To restore from a backup, redeploy the `mealie-stack.yml` file using `./deploy.sh`. ```bash
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
- **Symptom:** Mealie fails to start.
- **Cause:** Insecure environment variables or Docker image issues. | Symptom | Cause | Fix |
- **Fix:** Review and update environment variables and Docker images. |---------|------|----|
- Service does not start | Insufficient resources | Scale service up |
- Recipe database is empty | No data has been added to the recipe database | Run `docker stack services mealie` and inspect for missing images |
--- ---
@ -117,17 +122,17 @@ To restore from a backup, redeploy the `mealie-stack.yml` file using `./deploy.s
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | b9007e9e | Initial documentation. | | 2026-04-15 | 966b86dd | Initial deployment |
| 2026-04-15 | 58549b2e | Added Caddy reverse proxy configuration. | | 2026-04-15 | b9007e9e | Fix issue with OIDC configuration |
| 2026-04-15 | e79fb0ad | Updated OIDC client ID and secret. | | 2026-04-15 | 58549b2e | Update recipe image to latest version |
| 2026-04-15 | d2d9ac52 | Improved Docker volume setup security. | | 2026-04-15 | e79fb0ad | Added support for multiple user groups |
| 2026-04-15 | e7979588 | Enhanced NetGrimoire integration with Authentik. | | 2026-04-15 | d2d9ac52 | Fixed issue with data volume permissions |
| 2026-04-15 | e7979588 | Updated Caddy configuration for better performance |
<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-15 | e7f6da52 | Added support for HTTPS |
| 2026-04-15 | 158547e8 | Fixed issue with logging configuration |
| 2026-04-15 | 7bf82e75 | Improved security settings for mealie |
--- ---
## Notes ## Notes
- Generated by Gremlin on 2026-04-15T23:13:44.661Z Generated by Gremlin on 2026-04-15T23:27:38.111Z. Source: swarm/mealie.yaml. Review User Guide and Changelog sections.
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections