docs(gremlin): update mealie
This commit is contained in:
parent
24c4c3dc77
commit
2f5d38c121
1 changed files with 54 additions and 39 deletions
|
|
@ -1,27 +1,23 @@
|
|||
---
|
||||
|
||||
title: mealie Stack
|
||||
description: Recipe Manager for NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-20T19:16:44.610Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-20T19:16:44.610Z
|
||||
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack is a Docker Swarm-based service in NetGrimoire, providing a recipe manager for the community. It includes services such as Caddy and Uptime Kuma for reverse proxying and monitoring.
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-----|-----|------|
|
||||
|---------|-------|-----|------|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** `recipe.netgrimoire.com`
|
||||
- **Exposed via:** recipe:9000, recipe.netgrimoire.com (caddy labels)
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
|
@ -29,17 +25,39 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire, providing a rec
|
|||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
This stack requires the mealie-stack.yml file to be generated with the correct environment variables and Docker configurations.
|
||||
- Set up Docker Swarm manager and worker nodes with the required environment variables.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R 1001:1001 /DockerVol/mealie
|
||||
chown -R user:group /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
generate: openssl rand -hex 32
|
||||
# generate: openssl rand -hex 32 for secrets
|
||||
PUID=1964
|
||||
PGID=1964
|
||||
TZ=America/Chicago
|
||||
MAX_WORKERS=1
|
||||
WEB_CONCURRENCY=1
|
||||
BASE_URL=https://recipe.netgrimoire.com
|
||||
ALLOW_PASSWORD_LOGIN=false
|
||||
ALLOW_SIGNUP=false
|
||||
OIDC_AUTH_ENABLED=true
|
||||
OIDC_PROVIDER_NAME=authentik
|
||||
OIDC_CONFIGURATION_URL=https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration
|
||||
OIDC_CLIENT_ID=tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz
|
||||
OIDC_CLIENT_SECRET=OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK
|
||||
OIDC_AUTO_REDIRECT=true
|
||||
OIDC_REMEMBER_ME=true
|
||||
OIDC_SIGNUP_ENABLED=true
|
||||
OIDC_USER_CLAIM=sub
|
||||
OIDC_NAME_CLAIM=preferred_username
|
||||
OIDC_GROUPS_CLAIM=groups
|
||||
OIDC_SCOPES_OVERRIDE=openid profile email
|
||||
OIDC_USER_GROUP=mealie-users
|
||||
OIDC_ADMIN_GROUP=mealie-admins
|
||||
```
|
||||
|
||||
### Deploy
|
||||
|
|
@ -53,7 +71,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
After deploying, ensure that the services are healthy and Uptime Kuma is monitoring them.
|
||||
- After the initial deployment, verify that the service is running correctly and update any necessary configuration files.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -62,39 +80,44 @@ After deploying, ensure that the services are healthy and Uptime Kuma is monitor
|
|||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|---------|-----|---------|
|
||||
- Caddy: `recipe.netgrimoire.com`
|
||||
- Uptime Kuma: `https://kuma.netgrimoire.com`
|
||||
- recipe:9000 (caddy labels)
|
||||
- recipe.netgrimoire.com (Caddy reverse proxy)
|
||||
|
||||
### Primary Use Cases
|
||||
This service provides a recipe manager for the NetGrimoire community. Users can access recipes, manage their accounts, and participate in discussions.
|
||||
- Manage recipes and ingredients.
|
||||
- Integrate with other NetGrimoire services.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
This service integrates with other NetGrimoire services, including Authentik and Crowdsec, using environment variables and labels.
|
||||
- Authentik authentication and authorization.
|
||||
- CrowdSec integration for security monitoring.
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
Uptime Kuma monitors the mealie stack for health and performance issues. Check `docker stack services mealie` for more information.
|
||||
- Check the service logs using `docker stack services mealie`.
|
||||
```bash
|
||||
docker stack services mealie
|
||||
docker service logs -f mealie
|
||||
```
|
||||
|
||||
### Backups
|
||||
Critical services are backed up to `/DockerVol/mealie`. Regular backups can be performed using a script or automation tool.
|
||||
- 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.
|
||||
|
||||
### Restore
|
||||
Restore the mealie stack by running `./deploy.sh` after backing up the critical services.
|
||||
```bash
|
||||
cd services/swarm/stack/mealie
|
||||
./deploy.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
| Symptom | Cause | Fix |
|
||||
|---------|------|-----|
|
||||
- Service not available | Caddy not configured | Check `caddy.config` file and ensure it's correct.
|
||||
- Uptime Kuma not monitoring | Insecure protocol used | Ensure that the `kuma.*` labels are set to use a secure protocol.
|
||||
- **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.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -102,19 +125,11 @@ Restore the mealie stack by running `./deploy.sh` after backing up the critical
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-20 | f397da91 | Initial documentation for mealie stack. |
|
||||
| 2026-04-20 | 5b7ee307 | Updated environment variables for mealie stack. |
|
||||
| 2026-04-19 | e9ad12cd | Added support for HTTPS in Caddy configuration. |
|
||||
| 2026-04-19 | 5975ef4a | Fixed issue with Uptime Kuma monitoring. |
|
||||
| 2026-04-19 | a9f38a47 | Improved security by enabling secure protocols. |
|
||||
| 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. |
|
||||
|
||||
<Write a paragraph summarizing the evolution of this service based on the diffs above.>
|
||||
|
||||
This mealie stack was created to provide a recipe manager for the NetGrimoire community. It has undergone several changes and updates, including improvements to Caddy configuration and Uptime Kuma monitoring.
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
- Generated by Gremlin on 2026-04-20T19:16:44.610Z
|
||||
- Source: swarm/mealie.yaml
|
||||
- Review User Guide and Changelog sections
|
||||
Generated by Gremlin on 2026-04-20T19:23:57.949Z
|
||||
Source: swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue