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 @@
---
title: mealie Stack
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 Stack
description: Mealie Recipe Manager in NetGrimoire
# 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
| Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com
- **Exposed via:** recipe:9000, recipe.netgrimoire.com
- **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
### 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
```bash
mkdir -p /DockerVol/mealie
chown -R 1001:1001 /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie
```
### Environment Variables
@ -72,22 +61,21 @@ docker stack services mealie
```
### 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
### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
recipe.netgrimoire.com | recipe.netgrimoire.com | Mealie web application |
| Service | URL |
- **Host:** recipe.netgrimoire.com
### 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
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
Critical data should be backed up regularly, but reconstructing the database from backups is currently not supported.
Critical: `/DockerVol/mealie` and reconstructable: same
### Restore
```bash
@ -111,11 +99,9 @@ cd services/swarm/stack/mealie
---
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
* Mealie application crashes on startup | Insufficient resources | Increase node resources or scale up the stack |
* 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 |
- **Symptom:** Service is not accessible.
- **Cause:** Incorrect port mapping or network configuration.
- **Fix:** Reconfigure Caddy reverse proxy ports and ensure Mealie is reachable within the netgrimoire network.
---
@ -123,15 +109,17 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-15 | 3a30cd8a | Initial documentation creation |
| 2026-04-15 | ce9de8f3 | Update environment variables for OIDC provider configuration |
| 2026-04-15 | 1076a1ad | Implement first-run logic after deployment |
| 2026-04-15 | 6023da64 | Add support for backups and restore process |
| 2026-04-15 | 52bc39f9 | Update logging commands for monitoring |
| 2026-04-15 | fc964327 | Initial documentation created. |
| 2026-04-15 | 3a30cd8a | Updated environment variables with new values. |
| 2026-04-15 | ce9de8f3 | Improved versioning and release notes. |
| 2026-04-15 | 1076a1ad | Simplified deployment process. |
| 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
- Generated by Gremlin on 2026-04-16T03:27:57.689Z
- Generated by Gremlin on 2026-04-16T03:40:27.093Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections