docs(gremlin): update mealie
This commit is contained in:
parent
2f5d38c121
commit
7d8bee196f
1 changed files with 37 additions and 34 deletions
|
|
@ -1,23 +1,25 @@
|
|||
---
|
||||
|
||||
title: mealie Stack
|
||||
description: Recipe Manager for NetGrimoire
|
||||
|
||||
published: true
|
||||
date: 2026-04-20T19:31:01.116Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-20T19:31:01.116Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and integrates with other services such as Authentik and CrowdSec.
|
||||
|
||||
---
|
||||
The mealie stack is a Docker Swarm configuration for NetGrimoire that provides a Recipe Manager service. It consists of a single service, recipe, which runs the mealie application.
|
||||
|
||||
## Architecture
|
||||
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-------|-----|------|
|
||||
|---------|-------|------|------|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** recipe:9000, recipe.netgrimoire.com (caddy labels)
|
||||
- **Exposed via:** recipe:9000
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
|
@ -25,17 +27,17 @@ The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe ma
|
|||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
- Set up Docker Swarm manager and worker nodes with the required environment variables.
|
||||
No specific prerequisites are required for this stack.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R user:group /DockerVol/mealie
|
||||
chown -R www-data:www-data /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
# generate: openssl rand -hex 32 for secrets
|
||||
# generate: openssl rand -hex 32
|
||||
PUID=1964
|
||||
PGID=1964
|
||||
TZ=America/Chicago
|
||||
|
|
@ -71,7 +73,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
- After the initial deployment, verify that the service is running correctly and update any necessary configuration files.
|
||||
After the initial deployment, verify that the recipe service is running and accessible via Caddy.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -80,44 +82,41 @@ docker stack services mealie
|
|||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|---------|-----|---------|
|
||||
- recipe:9000 (caddy labels)
|
||||
- recipe.netgrimoire.com (Caddy reverse proxy)
|
||||
recipe: https://recipe.netgrimoire.com
|
||||
|
||||
### Primary Use Cases
|
||||
- Manage recipes and ingredients.
|
||||
- Integrate with other NetGrimoire services.
|
||||
The primary use case for this stack is to provide a Recipe Manager service in NetGrimoire. To access the recipe service, navigate to the Caddy domains listed in the labels.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
- Authentik authentication and authorization.
|
||||
- CrowdSec integration for security monitoring.
|
||||
This stack connects to other services in NetGrimoire via environment variables and labels. The specific integrations include:
|
||||
|
||||
- authentik
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
- Check the service logs using `docker stack services mealie`.
|
||||
Monitor the health of the recipe service using Kuma.
|
||||
|
||||
```bash
|
||||
docker stack services mealie
|
||||
docker service logs -f mealie
|
||||
```
|
||||
|
||||
### Backups
|
||||
- Store critical data in a separate, reconstructable volume to ensure data integrity.
|
||||
- Use `rsync` or similar tool to synchronize the backup with the production volume.
|
||||
Critical backups are required to ensure data integrity. Store backup images in a secure location.
|
||||
|
||||
### Restore
|
||||
```bash
|
||||
cd services/swarm/stack/mealie
|
||||
./deploy.sh
|
||||
```
|
||||
Restore the mealie service by redeploying from the swarm configuration file.
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
- **Service not running**: Check the service logs and verify that the Docker stack is deployed correctly.
|
||||
- **Authentication issues**: Ensure that the Authentik authentication settings are correct.
|
||||
- **Caddy reverse proxy configuration issues**: Verify that the Caddy labels are applied correctly.
|
||||
| Failure Mode | Symptoms | Cause | Fix |
|
||||
|-------------|----------|------|-----|
|
||||
| Service Not Running | Error message when accessing recipe service | Incorrect docker stack deploy command | Check logs and correct command |
|
||||
| Service Not Exposed | Recipe service not accessible via Caddy domains | Incorrect Caddy configuration | Review Caddy labels and update as necessary |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -125,11 +124,15 @@ cd services/swarm/stack/mealie
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-20 | c77cd7d4 | Initial documentation and setup. |
|
||||
| 2026-04-20 | f397da91 | Minor bug fixes and code optimizations. |
|
||||
| 2026-04-20 | 5b7ee307 | Improved Caddy reverse proxy configuration. |
|
||||
| 2026-04-19 | e9ad12cd | Authentik authentication settings updated. |
|
||||
| 2026-04-20 | 47b684b0 | Initial documentation for mealie stack |
|
||||
| 2026-04-20 | c77cd7d4 | Added environment variables for OIDC authentication |
|
||||
| 2026-04-20 | f397da91 | Updated Caddy labels and configuration |
|
||||
| 2026-04-20 | 5b7ee307 | Improved documentation formatting and clarity |
|
||||
| 2026-04-19 | e9ad12cd | Initial version of mealie stack |
|
||||
|
||||
Generated by Gremlin on 2026-04-20T19:23:57.949Z
|
||||
Source: swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
---
|
||||
|
||||
## Notes
|
||||
- Generated by Gremlin on 2026-04-20T19:31:01.116Z
|
||||
- Source: swarm/mealie.yaml
|
||||
- Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue