docs(gremlin): update mealie
This commit is contained in:
parent
5d0090f233
commit
a77e44396e
1 changed files with 36 additions and 29 deletions
|
|
@ -1,27 +1,28 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Recipe Manager
|
||||
description: Recipe Manager for NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-16T02:21:29.671Z
|
||||
date: 2026-04-16T02:42:01.339Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-16T02:21:29.671Z
|
||||
dateCreated: 2026-04-16T02:42:01.339Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack provides a recipe management service in NetGrimoire. It includes services such as Caddy for reverse proxying and Uptime Kuma for monitoring. The primary service provided by this stack is the Mealie recipe manager.
|
||||
The mealie stack is a Recipe Manager service for NetGrimoire, providing a web-based interface to manage recipes and access recipe-related data.
|
||||
|
||||
---
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-------|------|-------|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** recipe.netgrimoire.com, 9000
|
||||
- **Exposed via:** `recipe.netgrimoire.com`, `caddy:9000`
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
||||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
|
|
@ -30,11 +31,12 @@ No specific prerequisites are required for this stack.
|
|||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R mealie:mealie /DockerVol/mealie
|
||||
chown -R 1001:1001 /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```
|
||||
```bash
|
||||
# generate: openssl rand -hex 32
|
||||
PUID=1001
|
||||
PGID=998
|
||||
TZ=America/Chicago
|
||||
|
|
@ -70,25 +72,27 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
No specific post-deploy steps are required.
|
||||
After deploying the service, ensure that all necessary environment variables are set and the database is up-to-date.
|
||||
|
||||
---
|
||||
|
||||
## User Guide
|
||||
|
||||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
- Caddy: recipe.netgrimoire.com, 9000
|
||||
- Uptime Kuma: kuma.recipe.http.name=Mealie, https://recipe.netgrimoire.com
|
||||
|---------|-----|---------|
|
||||
- **Caddy Reverse Proxy:** `recipe.netgrimoire.com`, `caddy:9000`
|
||||
- **Uptime Kuma Monitoring:** `kuma.recipe.http.name=Mealie` [link to monitoring dashboard]
|
||||
|
||||
### Primary Use Cases
|
||||
To access the Mealie recipe manager, navigate to the provided URL in a web browser. The primary use case for this service is managing recipes.
|
||||
To use the mealie stack, navigate to `https://recipe.netgrimoire.com` and log in with your credentials.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
This service connects to Authentik and CrowdSec through environment variables and labels.
|
||||
The mealie stack integrates with other services through environment variables and labels, including:
|
||||
|
||||
* Authentik for OIDC authentication
|
||||
* Uptime Kuma for monitoring
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
|
|
@ -98,7 +102,7 @@ docker service logs -f mealie
|
|||
```
|
||||
|
||||
### Backups
|
||||
The `/DockerVol/mealie` directory is critical for backup purposes. Critical vs reconstructable backups are recommended due to the sensitive nature of this service's data.
|
||||
Critical: Regular backups of the database and application data are necessary to prevent data loss.
|
||||
|
||||
### Restore
|
||||
```bash
|
||||
|
|
@ -107,12 +111,14 @@ cd services/swarm/stack/mealie
|
|||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
| Symptom | Cause | Fix |
|
||||
- Service does not start.
|
||||
- Cause: Caddy or Uptime Kuma not running.
|
||||
- Fix: Check the service logs and restart the services if necessary.
|
||||
| Failure Mode | Symptoms | Cause | Fix |
|
||||
|-------------|----------|------|-----|
|
||||
| Service Not Responding | Service is not responding. | Insufficient resources or container restart required. | Restart service `docker service restart mealie` |
|
||||
|
||||
| Database Issues | Data loss or inconsistencies in the database. | Critical: Regular backups are necessary to prevent data loss. | Check database logs and ensure regular backups are in place.|
|
||||
|
||||
| Caddy Configuration Error | Caddy is not configured correctly, leading to broken URLs or other issues. | Insufficient configuration options or incorrect settings. | Review Caddy configuration and update as needed.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -120,12 +126,13 @@ cd services/swarm/stack/mealie
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-15 | 52bc39f9 | Initial commit with swarm configuration. |
|
||||
| 2026-04-15 | b490ae5d | Added environment variables for authentication. |
|
||||
| 2026-04-15 | 89277943 | Fixed Caddy reverse proxy to point to the correct URL. |
|
||||
| 2026-04-15 | 765f47e1 | Added Uptime Kuma monitoring configuration. |
|
||||
| 2026-04-15 | 9bed890d | Updated environment variables for new authentik configuration. |
|
||||
| 2026-04-15 | b9007e9e | Initial documentation for mealie stack |
|
||||
|
||||
Generated by Gremlin on 2026-04-16T02:21:29.671Z
|
||||
Source: swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
<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.>
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
- Generated by Gremlin on 2026-04-16T02:42:01.339Z
|
||||
- Source: swarm/mealie.yaml
|
||||
- Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue