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 title: mealie Stack
description: Mealie recipe manager in NetGrimoire. description: Recipe Manager
published: true published: true
date: 2026-04-23T04:09:20.245Z date: 2026-04-23T11:36:00.635Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-23T04:09:20.245Z dateCreated: 2026-04-23T11:36:00.635Z
--- ---
# mealie # mealie
## Overview ## 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com, 9927:9000 - **Exposed via:** `recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -27,7 +28,7 @@ The mealie stack is a Docker Swarm configuration for the Mealie recipe manager i
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
None specified. No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
@ -73,7 +74,7 @@ docker stack services mealie
``` ```
### First Run ### 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 ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
- **Host:** recipe.netgrimoire.com, 9927:9000 - **Host:** `recipe.netgrimoire.com`
- **Login**: no password login available. - **Port:** 9000
- **Signup**: no signup feature available.
### Primary Use Cases ### 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 ### NetGrimoire Integrations
This service integrates with Authentik for OIDC authentication. This service connects to other services via OIDC authentication with authentik.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
[kuma.name: Mealie, kuma.url: https://recipe.netgrimoire.com]
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie <docker service logs commands>
``` ```
### Backups ### 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 ### Restore
Run `./deploy.sh` to restore the service from a backup. ```bash
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
- **Service not available**: Check the status of the stack: `docker stack services mealie`. | Symptom | Cause | Fix |
- **Login issues**: Clear cache in browser or try another browser. - **Failed deployment** | Insufficient disk space on docker4. | Check and increase available storage. |
- **Signing up fails**: Contact support or check the OIDC configuration URL for errors. - **Login issues** | Incorrect credentials or authentication configuration error. | Verify that the OIDC configuration is correct and redeploy if necessary. |
- **Authentik integration issues**: Check Authentik logs and OIDC configuration for errors. - **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 | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-22 | ce657f97 | Initial documentation creation. | | 2026-04-23 | 9d75346d | Initial documentation |
| 2026-04-22 | 85531b16 | Minor formatting changes. | | 2026-04-22 | ce657f97 | |
| 2026-04-21 | a942ffb9 | Bug fix: fixed typo in environment variable. | | 2026-04-22 | 85531b16 | |
| 2026-04-21 | fdd16eff | Documentation update: added section on primary use cases. | | 2026-04-21 | a942ffb9 | |
| 2026-04-21 | 1829bf97 | Minor formatting changes. | | 2026-04-21 | fdd16eff | |
Generated by Gremlin on 2026-04-23T04:09:20.245Z ---
Source: swarm/mealie.yaml
Review User Guide and Changelog sections