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-23 06:38:05 -05:00
parent 9374a267ea
commit ce338c52fb
1 changed files with 28 additions and 28 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,25 +1,26 @@
---
title: mealie Stack
description: Mealie recipe manager in NetGrimoire.
description: Recipe Manager
published: true
date: 2026-04-23T04:09:20.245Z
date: 2026-04-23T11:36:00.635Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-23T04:09:20.245Z
dateCreated: 2026-04-23T11:36:00.635Z
---
# mealie
## Overview
The mealie stack is a Docker Swarm configuration for the Mealie recipe manager in NetGrimoire. It provides a secure and scalable platform for managing recipes.
The mealie stack is a Recipe Manager service in NetGrimoire. It provides features such as recipe management and authentication.
---
## Architecture
| Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com, 9927:9000
- **Exposed via:** `recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps
---
@ -27,7 +28,7 @@ The mealie stack is a Docker Swarm configuration for the Mealie recipe manager i
## Build & Configuration
### Prerequisites
None specified.
No specific prerequisites are required for this stack.
### Volume Setup
```bash
@ -73,7 +74,7 @@ docker stack services mealie
```
### First Run
Run `./deploy.sh` to initialize the service.
After deployment, you need to update the kuma configuration and redeploy.
---
@ -81,40 +82,41 @@ Run `./deploy.sh` to initialize the service.
### Accessing mealie
| Service | URL | Purpose |
- **Host:** recipe.netgrimoire.com, 9927:9000
- **Login**: no password login available.
- **Signup**: no signup feature available.
- **Host:** `recipe.netgrimoire.com`
- **Port:** 9000
### Primary Use Cases
The primary use case is to manage recipes and access the web interface at recipe.netgrimoire.com.
To use this service in NetGrimoire, navigate to the Recipe Manager page on your dashboard and create a new recipe or manage existing ones.
### NetGrimoire Integrations
This service integrates with Authentik for OIDC authentication.
This service connects to other services via OIDC authentication with authentik.
---
## Operations
### Monitoring
[kuma.name: Mealie, kuma.url: https://recipe.netgrimoire.com]
```bash
docker stack services mealie
docker service logs -f mealie
<docker service logs commands>
```
### Backups
Critical services are stored in /DockerVol/mealie and must be backed up regularly.
Critical backups are not available. Restores may be required if data is lost due to an error or intentional deletion.
### Restore
Run `./deploy.sh` to restore the service from a backup.
```bash
cd services/swarm/stack/mealie
./deploy.sh
```
---
## Common Failures
- **Service not available**: Check the status of the stack: `docker stack services mealie`.
- **Login issues**: Clear cache in browser or try another browser.
- **Signing up fails**: Contact support or check the OIDC configuration URL for errors.
- **Authentik integration issues**: Check Authentik logs and OIDC configuration for errors.
| Symptom | Cause | Fix |
- **Failed deployment** | Insufficient disk space on docker4. | Check and increase available storage. |
- **Login issues** | Incorrect credentials or authentication configuration error. | Verify that the OIDC configuration is correct and redeploy if necessary. |
- **Recipe not saved** | Data write failure due to permissions issue. | Check the file system permissions for the Docker volume and ensure they are set correctly. |
---
@ -122,12 +124,10 @@ Run `./deploy.sh` to restore the service from a backup.
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-22 | ce657f97 | Initial documentation creation. |
| 2026-04-22 | 85531b16 | Minor formatting changes. |
| 2026-04-21 | a942ffb9 | Bug fix: fixed typo in environment variable. |
| 2026-04-21 | fdd16eff | Documentation update: added section on primary use cases. |
| 2026-04-21 | 1829bf97 | Minor formatting changes. |
| 2026-04-23 | 9d75346d | Initial documentation |
| 2026-04-22 | ce657f97 | |
| 2026-04-22 | 85531b16 | |
| 2026-04-21 | a942ffb9 | |
| 2026-04-21 | fdd16eff | |
Generated by Gremlin on 2026-04-23T04:09:20.245Z
Source: swarm/mealie.yaml
Review User Guide and Changelog sections
---