docs(gremlin): update mealie
This commit is contained in:
parent
1a2b810453
commit
9374a267ea
1 changed files with 34 additions and 35 deletions
|
|
@ -1,41 +1,43 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Recipe Manager for NetGrimoire
|
||||
description: Mealie recipe manager in NetGrimoire.
|
||||
published: true
|
||||
date: 2026-04-23T04:09:18.782Z
|
||||
date: 2026-04-23T04:09:20.245Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-23T04:09:18.782Z
|
||||
dateCreated: 2026-04-23T04:09:20.245Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack is a Docker Swarm-based Recipe Manager service for NetGrimoire. It provides a web-based interface for users to manage recipes and access cooking-related content.
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-----|-----|-----|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- Exposed via: recipe.netgrimoire.com, recipe:9000 (caddy labels)
|
||||
- Homepage group: PNCHarris Apps
|
||||
- **Exposed via:** recipe.netgrimoire.com, 9927:9000
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
||||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
No specific prerequisites are required for this stack.
|
||||
None specified.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie/data
|
||||
chown -R mealie:mealie /DockerVol/mealie/data
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R user:group /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
# generate: openssl rand -hex 32
|
||||
PUID=1964
|
||||
PGID=1964
|
||||
TZ=America/Chicago
|
||||
|
|
@ -71,7 +73,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
No specific post-deploy steps are required for this service.
|
||||
Run `./deploy.sh` to initialize the service.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -79,44 +81,40 @@ No specific post-deploy steps are required for this service.
|
|||
|
||||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|---------|-----|---------|
|
||||
- recipe.netgrimoire.com
|
||||
- recipe:9000 (caddy labels)
|
||||
- **Host:** recipe.netgrimoire.com, 9927:9000
|
||||
- **Login**: no password login available.
|
||||
- **Signup**: no signup feature available.
|
||||
|
||||
### Primary Use Cases
|
||||
This service is used to manage recipes and access cooking-related content in NetGrimoire.
|
||||
The primary use case is to manage recipes and access the web interface at recipe.netgrimoire.com.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
This service connects to other services such as authentik for OIDC authentication.
|
||||
This service integrates with Authentik for OIDC authentication.
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
[kuma monitors from kuma.* labels]
|
||||
[kuma.name: Mealie, kuma.url: https://recipe.netgrimoire.com]
|
||||
```bash
|
||||
docker stack services mealie
|
||||
docker service logs mealie
|
||||
docker service logs -f mealie
|
||||
```
|
||||
|
||||
### Backups
|
||||
Critical and reconstructable /DockerVol/mealie/data paths require regular backups to ensure data integrity.
|
||||
Critical services are stored in /DockerVol/mealie and must be backed up regularly.
|
||||
|
||||
### Restore
|
||||
```bash
|
||||
cd services/swarm/stack/mealie
|
||||
./deploy.sh
|
||||
```
|
||||
Run `./deploy.sh` to restore the service from a backup.
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
| Symptom | Cause | Fix |
|
||||
|---------|-------|-----|
|
||||
| Service not available | Caddy not configured | Check caddy labels and config |
|
||||
| OIDC authentication issues | Authentik provider issues | Check authentik provider status |
|
||||
| Data loss | Disk failure | Regularly back up data to /DockerVol/mealie/data |
|
||||
- **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.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -124,11 +122,12 @@ cd services/swarm/stack/mealie
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-22 | 85531b16 | Initial documentation and setup |
|
||||
| 2026-04-21 | a942ffb9 | Added OIDC configuration and authentication |
|
||||
| 2026-04-21 | fdd16eff | Implemented caddy reverse proxy for recipe.netgrimoire.com |
|
||||
| 2026-04-21 | 1829bf97 | Updated env variables for mealie-users and mealie-admins groups |
|
||||
| 2026-04-20 | 67ef1d4b | Fixed caddy import_1 and import_2 labels |
|
||||
| 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. |
|
||||
|
||||
<Written by Gremlin on 2026-04-23T04:09:18.782Z>
|
||||
<Source: swarm/mealie.yaml>
|
||||
Generated by Gremlin on 2026-04-23T04:09:20.245Z
|
||||
Source: swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue