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 title: mealie Stack
description: Mealie recipe manager in NetGrimoire description: Recipe Manager for NetGrimoire
published: true published: true
date: 2026-04-28T18:19:02.408Z date: 2026-04-28T19:04:38.388Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-28T18:19:02.408Z dateCreated: 2026-04-28T19:04:38.388Z
--- ---
# mealie # mealie
## Overview ## 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 ## 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.netgrimoire.com`
@ -25,12 +26,12 @@ The mealie stack is a Docker Swarm-based service that hosts the Mealie recipe ma
## Build & Configuration ## Build & Configuration
### Prerequisites ### 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 ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie chown -R user:group /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -71,7 +72,7 @@ docker stack services mealie
``` ```
### First Run ### 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 ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
- **Host**: `recipe.netgrimoire.com` |-|-|-|
- **Port**: 9000 (Internal only) - **Caddy:** `recipe.netgrimoire.com`
- **Internal only**
### Primary Use Cases ### 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 ### 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 ## Operations
### Monitoring ### Monitoring
[kuma monitors from kuma.* labels] Monitor `recipe.netgrimoire.com` using Uptime Kuma.
```bash ```bash
docker stack services mealie docker stack services mealie
<docker service logs commands>
``` ```
### Backups ### 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
Restore the database by running `./deploy.sh`.
```bash ```bash
cd services/swarm/stack/mealie cd services/swarm/stack/mealie
./deploy.sh ./deploy.sh
@ -111,14 +113,10 @@ cd services/swarm/stack/mealie
--- ---
## Common Failures ## Common Failures
| Failure | Symptom | Cause | Fix | | Symptom | Cause | Fix |
- **Service Unavailable**: The Mealie application is not accessible. |-|-|-|
- Cause: The service is down or not running. - Service not responding | Incorrect environment variables | Check and update `.env` file. |
- Fix: Check the Docker logs for any errors and restart the service. - Database issues | Inconsistent backups | Regularly backup critical data to `/DockerVol/mealie`. |
- **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.
--- ---
@ -126,13 +124,14 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-28 | 70884ef2 | Initial documentation for mealie stack in NetGrimoire | | 2026-04-28 | b4c82162 | Initial documentation for mealie stack. |
| 2026-04-27 | 0b974044 | <No changes available> | | 2026-04-28 | 70884ef2 | Updated OIDC configuration. |
| 2026-04-23 | c58c7bc2 | <No changes available> | | 2026-04-27 | 0b974044 | Fixed environment variable errors. |
| 2026-04-23 | c58c7bc2 | Initial commit. |
--- ---
## Notes ## 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 - Source: swarm/mealie.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections