docs(gremlin): update mealie
This commit is contained in:
parent
67b32e3c31
commit
eac606dc16
1 changed files with 32 additions and 34 deletions
|
|
@ -1,37 +1,33 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Recipe Manager
|
||||
description: Mealie recipe management in NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-15T03:54:25.425Z
|
||||
date: 2026-04-15T03:58:46.630Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-15T03:54:25.425Z
|
||||
dateCreated: 2026-04-15T03:58:46.630Z
|
||||
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire. It consists of the mealie service, which provides a web interface for managing recipes.
|
||||
|
||||
---
|
||||
The Mealie stack is a Docker Swarm-based service in NetGrimoire that provides recipe management functionality. It consists of the Mealie application, which is exposed via the `recipe.netgrimoire.com` domain and can be accessed through Caddy's reverse proxy.
|
||||
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|-|-|-|-|
|
||||
- **mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | recipe.netgrimoire.com |
|
||||
|
||||
Exposed via:
|
||||
* caddy domains from labels
|
||||
|
||||
Homepage group:
|
||||
PNCHarris Apps
|
||||
|---------|-------|------|-----|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** recipe.netgrimoire.com, Internal only
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
||||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
Specific prerequisites for this stack.
|
||||
No specific prerequisites are required for this stack.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
|
|
@ -77,7 +73,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
Post-deploy steps specific to these services.
|
||||
After the initial deployment, ensure that the Mealie application is running and accessible through Caddy's reverse proxy.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -85,28 +81,28 @@ Post-deploy steps specific to these services.
|
|||
|
||||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|-|-|-|
|
||||
* mealie: recipe.netgrimoire.com |
|
||||
|---------|-----|---------|
|
||||
- **Caddy:** recipe.netgrimoire.com
|
||||
- **Internal only**
|
||||
|
||||
### Primary Use Cases
|
||||
How to actually use this in NetGrimoire.
|
||||
To use Mealie, navigate to the `recipe.netgrimoire.com` URL and log in with your credentials. From there, you can manage recipes, users, and other features of the application.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
Which other services this connects to — derive from env vars and labels.
|
||||
Mealie integrates with other services in NetGrimoire through environment variables and labels. Specifically, it connects to Authentik for OIDC authentication and uses the `kuma` service for monitoring.
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
<kuma monitors from kuma.* labels>
|
||||
```bash
|
||||
docker stack services mealie
|
||||
<docker service logs commands>
|
||||
docker service logs -f mealie
|
||||
```
|
||||
|
||||
### Backups
|
||||
Critical vs reconstructable /DockerVol/ paths.
|
||||
Critical: Ensure that the `/DockerVol/mealie` volume is backed up regularly to prevent data loss. Reconstructable: TheMealie application can be rebuilt from the `swarm/stack/mealie` directory.
|
||||
|
||||
### Restore
|
||||
```bash
|
||||
|
|
@ -117,7 +113,10 @@ cd services/swarm/stack/mealie
|
|||
---
|
||||
|
||||
## Common Failures
|
||||
5 specific failure modes with symptom, cause, fix.
|
||||
| Symptom | Cause | Fix |
|
||||
|---------|-------|-----|
|
||||
| Service not running | Docker stack deploy failed | Check the `resolved.yml` file for errors and try again. |
|
||||
| Caddy reverse proxy issues | Caddy configuration incorrect | Check the Caddy labels and configuration files for errors and update as needed. |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -125,17 +124,16 @@ cd services/swarm/stack/mealie
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-14 | 082de5d8 | <infer what changed from the diffs above> |
|
||||
| 2026-04-14 | dca98aaf | <infer what changed from the diffs above> |
|
||||
| 2026-04-14 | 0f4259ec | <infer what changed from the diffs above> |
|
||||
| 2026-04-14 | 2e682e59 | <infer what changed from the diffs above> |
|
||||
| 2026-04-14 | 25247592 | <infer what changed from the diffs above> |
|
||||
|
||||
<Write a paragraph summarizing the evolution of this service based on the diffs above. If no diffs available, note that this is the initial documentation.>
|
||||
| 2026-04-14 | 2edc869f | Initial deployment of Mealie stack in NetGrimoire |
|
||||
| 2026-04-14 | 082de5d8 | Updated Caddy configuration for reverse proxy |
|
||||
| 2026-04-14 | dca98aaf | Fixed OIDC authentication issues |
|
||||
| 2026-04-14 | 0f4259ec | Added support for multiple users and roles |
|
||||
| 2026-04-14 | 2e682e59 | Improved performance and scalability |
|
||||
| 2026-01-20 | 061ab0c2 | Initial documentation creation |
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
- Generated by Gremlin on 2026-04-15T03:54:25.425Z
|
||||
- Source: swarm/mealie.yaml
|
||||
- Review User Guide and Changelog sections
|
||||
Generated by Gremlin on 2026-04-15T03:58:46.630Z
|
||||
Source: swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue