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-28 13:21:09 -05:00
parent 6454d16772
commit a44b556215
1 changed files with 36 additions and 30 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,31 +1,31 @@
---
title: mealie Stack
description: Mealie recipe manager
description: Mealie recipe manager in NetGrimoire
published: true
date: 2026-04-24T04:48:34.567Z
date: 2026-04-28T18:19:02.408Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-24T04:48:34.567Z
dateCreated: 2026-04-28T18:19:02.408Z
---
# mealie
## Overview
The mealie stack provides a recipe manager service for NetGrimoire. It consists of the mealie service, which is responsible for managing recipes and providing a user-friendly interface.
The mealie stack is a Docker Swarm-based service that hosts the Mealie recipe manager in NetGrimoire. It provides a web interface for users to create, edit and manage recipes. The stack consists of a single service, which runs the Mealie application.
## Architecture
| Service | Image | Port | Role |
|---------|-----|-----|-------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com, Internal only
- **Exposed via:** `recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps
---
## Build & Configuration
### Prerequisites
Ensure you have the necessary Docker and Caddy configurations in place.
No specific prerequisites are required for this stack.
### Volume Setup
```bash
@ -71,34 +71,36 @@ docker stack services mealie
```
### First Run
No specific steps required for a first run.
No specific steps are required for the first run.
---
## User Guide
### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
- recipe.netgrimoire.com
- **Host**: `recipe.netgrimoire.com`
- **Port**: 9000 (Internal only)
### Primary Use Cases
Access the recipe manager service to manage recipes and provide a user-friendly interface.
To access the Mealie recipe manager, navigate to `https://recipe.netgrimoire.com` in your web browser.
### NetGrimoire Integrations
This service connects to authentik for OIDC authentication.
The mealie stack connects to other services through environment variables and labels. Specifically, it integrates with Authentik for OIDC authentication.
---
## Operations
### Monitoring
[kuma monitors from kuma.* labels]
```bash
docker stack services mealie
docker service logs -f mealie
<docker service logs commands>
```
### Backups
Critical: Regular backups of the recipe data are necessary. The /DockerVol/mealie directory should be backed up regularly.
Reconstructable: The configuration files can be rebuilt from the Docker Stack.
Critical data should be backed up regularly. Reconstructing the data may not always be possible.
### Restore
```bash
@ -107,26 +109,30 @@ cd services/swarm/stack/mealie
```
---
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|------|
- Service not accessible | Caddy not running | Restart caddy service |
- Recipe data lost | Regular backups not executed | Execute regular backup routine |
- Config file corrupted | Incorrect config file version | Update config file to latest version |
- OIDC authentication issues | authentik configuration incorrect | Review and update authentik configuration |
- Recipe management errors | Mealie configuration incorrect | Review and update mealie configuration |
| Failure | Symptom | Cause | Fix |
- **Service Unavailable**: The Mealie application is not accessible.
- Cause: The service is down or not running.
- Fix: Check the Docker logs for any errors and restart the service.
- **Login Issues**: Users are unable to log in to the Mealie application.
- Cause: The OIDC authentication configuration is incorrect or expired.
- Fix: Review and update the OIDC configuration and client secret.
---
## Changelog
| Date | Commit | Summary |
|------|--------|---------|
- 2026-04-23 | c58c7bc2 | Initial documentation creation |
| 2026-04-23 | 8fbdfbec | Update Caddy reverse proxy label |
| 2026-04-23 | 1cc32c85 | Update homepage description |
| 2026-04-23 | f00d649e | Update NetGrimoire integrations section |
| 2026-04-23 | 824ed13e | Update common failures section |
| 2026-04-28 | 70884ef2 | Initial documentation for mealie stack in NetGrimoire |
| 2026-04-27 | 0b974044 | <No changes available> |
| 2026-04-23 | c58c7bc2 | <No changes available> |
<Generated by Gremlin on 2026-04-24T04:48:34.567Z>
<Source: swarm/mealie.yaml>
<Review User Guide and Changelog sections>
---
## Notes
- Generated by Gremlin on 2026-04-28T18:19:02.408Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections