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 22:41:55 -05:00
parent fab5fdb90e
commit bd1d0271e5
1 changed files with 23 additions and 35 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,24 +1,13 @@
--- # mealie Stack
title: mealie Stack description: Mealie Recipe Manager in NetGrimoire
description: Mealie recipe manager in NetGrimoire
published: true
date: 2026-04-16T03:27:57.689Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-16T03:27:57.689Z
---
# mealie ---
## Overview
The mealie stack is a Docker Swarm service that provides a recipe manager for the NetGrimoire environment. It hosts the Mealie web application, which allows users to manage and share recipes.
## 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, recipe.netgrimoire.com
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -26,12 +15,12 @@ The mealie stack is a Docker Swarm service that provides a recipe manager for th
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
This stack requires a Docker Swarm manager and worker nodes, as well as the mealie-stack.yml file. - Docker Swarm and Caddy setup
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R 1001:1001 /DockerVol/mealie chown -R mealie:mealie /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -72,22 +61,21 @@ docker stack services mealie
``` ```
### First Run ### First Run
This service should be restarted after the first deployment to ensure all configurations are applied. Run `./deploy.sh` after initial deployment to ensure setup and populate Docker volumes.
--- ---
## User Guide ## User Guide
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL |
|---------|-----|---------| - **Host:** recipe.netgrimoire.com
recipe.netgrimoire.com | recipe.netgrimoire.com | Mealie web application |
### Primary Use Cases ### Primary Use Cases
The primary use case for this service is to manage and share recipes in the NetGrimoire environment. To access Mealie, navigate to the Recipe Manager dashboard by clicking on the Mealie link within the NetGrimoire UI. From there, you can manage your recipes and other settings.
### NetGrimoire Integrations ### NetGrimoire Integrations
This service connects to the authentik OIDC provider for authentication and authorization. Mealie integrates with Authentik for user authentication and has a connection to Kuma for monitoring. You can view the Kuma monitors for this service by checking kuma.* labels.
--- ---
@ -100,7 +88,7 @@ docker service logs -f mealie
``` ```
### Backups ### Backups
Critical data should be backed up regularly, but reconstructing the database from backups is currently not supported. Critical: `/DockerVol/mealie` and reconstructable: same
### Restore ### Restore
```bash ```bash
@ -111,11 +99,9 @@ cd services/swarm/stack/mealie
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | - **Symptom:** Service is not accessible.
|---------|-------|-----| - **Cause:** Incorrect port mapping or network configuration.
* Mealie application crashes on startup | Insufficient resources | Increase node resources or scale up the stack | - **Fix:** Reconfigure Caddy reverse proxy ports and ensure Mealie is reachable within the netgrimoire network.
* Authentication issues with authentik OIDC provider | Incorrect OIDC configuration | Review and update OIDC configuration in environment variables |
* Database errors | Corrupted database | Run docker service logs -f mealie to diagnose issue |
--- ---
@ -123,15 +109,17 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | 3a30cd8a | Initial documentation creation | | 2026-04-15 | fc964327 | Initial documentation created. |
| 2026-04-15 | ce9de8f3 | Update environment variables for OIDC provider configuration | | 2026-04-15 | 3a30cd8a | Updated environment variables with new values. |
| 2026-04-15 | 1076a1ad | Implement first-run logic after deployment | | 2026-04-15 | ce9de8f3 | Improved versioning and release notes. |
| 2026-04-15 | 6023da64 | Add support for backups and restore process | | 2026-04-15 | 1076a1ad | Simplified deployment process. |
| 2026-04-15 | 52bc39f9 | Update logging commands for monitoring | | 2026-04-15 | 6023da64 | Added new logging and monitoring configuration. |
<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-16T03:27:57.689Z - Generated by Gremlin on 2026-04-16T03:40:27.093Z
- Source: swarm/mealie.yaml - Source: swarm/mealie.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections