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 title: mealie Stack
description: Mealie recipe manager description: Mealie recipe manager in NetGrimoire
published: true published: true
date: 2026-04-24T04:48:34.567Z date: 2026-04-28T18:19:02.408Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-24T04:48:34.567Z dateCreated: 2026-04-28T18:19:02.408Z
--- ---
# mealie # mealie
## Overview ## 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|-------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com, Internal only - **Exposed via:** `recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
Ensure you have the necessary Docker and Caddy configurations in place. No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
@ -71,34 +71,36 @@ docker stack services mealie
``` ```
### First Run ### First Run
No specific steps required for a first run. No specific steps are required for the first run.
--- ---
## User Guide ## User Guide
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| - **Host**: `recipe.netgrimoire.com`
- recipe.netgrimoire.com - **Port**: 9000 (Internal only)
### Primary Use Cases ### 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 ### 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 ## 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 commands>
``` ```
### Backups ### Backups
Critical: Regular backups of the recipe data are necessary. The /DockerVol/mealie directory should be backed up regularly. Critical data should be backed up regularly. Reconstructing the data may not always be possible.
Reconstructable: The configuration files can be rebuilt from the Docker Stack.
### Restore ### Restore
```bash ```bash
@ -107,26 +109,30 @@ cd services/swarm/stack/mealie
``` ```
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Failure | Symptom | Cause | Fix |
|---------|-------|------| - **Service Unavailable**: The Mealie application is not accessible.
- Service not accessible | Caddy not running | Restart caddy service | - Cause: The service is down or not running.
- Recipe data lost | Regular backups not executed | Execute regular backup routine | - Fix: Check the Docker logs for any errors and restart the service.
- Config file corrupted | Incorrect config file version | Update config file to latest version |
- OIDC authentication issues | authentik configuration incorrect | Review and update authentik configuration | - **Login Issues**: Users are unable to log in to the Mealie application.
- Recipe management errors | Mealie configuration incorrect | Review and update mealie configuration | - Cause: The OIDC authentication configuration is incorrect or expired.
- Fix: Review and update the OIDC configuration and client secret.
--- ---
## Changelog ## Changelog
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
- 2026-04-23 | c58c7bc2 | Initial documentation creation | | 2026-04-28 | 70884ef2 | Initial documentation for mealie stack in NetGrimoire |
| 2026-04-23 | 8fbdfbec | Update Caddy reverse proxy label | | 2026-04-27 | 0b974044 | <No changes available> |
| 2026-04-23 | 1cc32c85 | Update homepage description | | 2026-04-23 | c58c7bc2 | <No changes available> |
| 2026-04-23 | f00d649e | Update NetGrimoire integrations section |
| 2026-04-23 | 824ed13e | Update common failures section |
<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