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 14:06:10 -05:00
parent a44b556215
commit 39a3b41650
1 changed files with 25 additions and 26 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,20 +1,21 @@
---
title: mealie Stack
description: Mealie recipe manager in NetGrimoire
description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-28T18:19:02.408Z
date: 2026-04-28T19:04:38.388Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-28T18:19:02.408Z
dateCreated: 2026-04-28T19:04:38.388Z
---
# mealie
## Overview
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.
The mealie stack is a Docker Swarm-based service in NetGrimoire that serves as a recipe manager. It provides a platform for users to discover, create, and share recipes.
## Architecture
| Service | Image | Port | Role |
|-|-|-|-|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com`
@ -25,12 +26,12 @@ The mealie stack is a Docker Swarm-based service that hosts the Mealie recipe ma
## Build & Configuration
### Prerequisites
No specific prerequisites are required for this stack.
To build and deploy the mealie stack, ensure you have Docker Swarm installed and configured.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie
chown -R user:group /DockerVol/mealie
```
### Environment Variables
@ -71,7 +72,7 @@ docker stack services mealie
```
### First Run
No specific steps are required for the first run.
Run `./deploy.sh` after deployment to initialize the database.
---
@ -79,30 +80,31 @@ No specific steps are required for the first run.
### Accessing mealie
| Service | URL | Purpose |
- **Host**: `recipe.netgrimoire.com`
- **Port**: 9000 (Internal only)
|-|-|-|
- **Caddy:** `recipe.netgrimoire.com`
- **Internal only**
### Primary Use Cases
To access the Mealie recipe manager, navigate to `https://recipe.netgrimoire.com` in your web browser.
To use this service in NetGrimoire, navigate to the homepage and explore the available recipes.
### NetGrimoire Integrations
The mealie stack connects to other services through environment variables and labels. Specifically, it integrates with Authentik for OIDC authentication.
This service connects to other services such as authentik for OIDC authentication.
---
## Operations
### Monitoring
[kuma monitors from kuma.* labels]
Monitor `recipe.netgrimoire.com` using Uptime Kuma.
```bash
docker stack services mealie
<docker service logs commands>
```
### Backups
Critical data should be backed up regularly. Reconstructing the data may not always be possible.
Critical data should be backed up by creating a `/DockerVol/mealie` volume on docker4.
### Restore
Restore the database by running `./deploy.sh`.
```bash
cd services/swarm/stack/mealie
./deploy.sh
@ -111,14 +113,10 @@ cd services/swarm/stack/mealie
---
## Common Failures
| 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.
| Symptom | Cause | Fix |
|-|-|-|
- Service not responding | Incorrect environment variables | Check and update `.env` file. |
- Database issues | Inconsistent backups | Regularly backup critical data to `/DockerVol/mealie`. |
---
@ -126,13 +124,14 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary |
|------|--------|---------|
| 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> |
| 2026-04-28 | b4c82162 | Initial documentation for mealie stack. |
| 2026-04-28 | 70884ef2 | Updated OIDC configuration. |
| 2026-04-27 | 0b974044 | Fixed environment variable errors. |
| 2026-04-23 | c58c7bc2 | Initial commit. |
---
## Notes
- Generated by Gremlin on 2026-04-28T18:19:02.408Z
- Generated by Gremlin on 2026-04-28T19:04:38.388Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections