docs(gremlin): update mealie
This commit is contained in:
parent
ef47086394
commit
24c4c3dc77
1 changed files with 36 additions and 54 deletions
|
|
@ -2,24 +2,26 @@
|
|||
title: mealie Stack
|
||||
description: Recipe Manager for NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-20T18:15:54.217Z
|
||||
date: 2026-04-20T19:16:44.610Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-20T18:15:54.217Z
|
||||
dateCreated: 2026-04-20T19:16:44.610Z
|
||||
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie Stack is a Docker Swarm-based Recipe Manager for NetGrimoire, providing a centralized platform for managing and sharing recipes.
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-------|------|------|
|
||||
|---------|-----|-----|------|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** recipe.netgrimoire.com
|
||||
- **Exposed via:** `recipe.netgrimoire.com`
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
|
@ -27,39 +29,17 @@ The mealie Stack is a Docker Swarm-based Recipe Manager for NetGrimoire, providi
|
|||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
No specific prerequisites are required for this stack.
|
||||
This stack requires the mealie-stack.yml file to be generated with the correct environment variables and Docker configurations.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R user:group /DockerVol/mealie
|
||||
chown -R 1001:1001 /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
# generate: openssl rand -hex 32
|
||||
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
|
||||
generate: openssl rand -hex 32
|
||||
```
|
||||
|
||||
### Deploy
|
||||
|
|
@ -73,7 +53,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
After deploying the mealie Stack, you may need to update the recipe database by running `./deploy.sh`.
|
||||
After deploying, ensure that the services are healthy and Uptime Kuma is monitoring them.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -82,41 +62,39 @@ After deploying the mealie Stack, you may need to update the recipe database by
|
|||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|---------|-----|---------|
|
||||
- **recipe:** https://recipe.netgrimoire.com
|
||||
- Caddy: `recipe.netgrimoire.com`
|
||||
- Uptime Kuma: `https://kuma.netgrimoire.com`
|
||||
|
||||
### Primary Use Cases
|
||||
To use this service in NetGrimoire, you can create a new recipe and share it with others. The recipe manager provides features for managing and sharing recipes.
|
||||
This service provides a recipe manager for the NetGrimoire community. Users can access recipes, manage their accounts, and participate in discussions.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
The mealie Stack integrates with other services in NetGrimoire, including Authentik and Uptime Kuma.
|
||||
This service integrates with other NetGrimoire services, including Authentik and Crowdsec, using environment variables and labels.
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
Monitoring the mealie Stack is handled by Uptime Kuma, which can be accessed at kuma.mealie.netgrimoire.com.
|
||||
|
||||
Uptime Kuma monitors the mealie stack for health and performance issues. Check `docker stack services mealie` for more information.
|
||||
```bash
|
||||
docker stack services mealie
|
||||
docker service logs -f mealie
|
||||
```
|
||||
|
||||
### Backups
|
||||
Backups of critical data are stored in `/DockerVol/mealie`. Regular backups should be performed to ensure data integrity.
|
||||
Critical services are backed up to `/DockerVol/mealie`. Regular backups can be performed using a script or automation tool.
|
||||
|
||||
### Restore
|
||||
To restore the mealie Stack from a backup, run `./deploy.sh`.
|
||||
Restore the mealie stack by running `./deploy.sh` after backing up the critical services.
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
|
||||
| Symptom | Cause | Fix |
|
||||
|---------|------|-----|
|
||||
1. Service not responding | Insufficient resources or incorrect configuration | Check resource allocation and update configuration as needed.
|
||||
2. Recipe database corruption | Incomplete backups or incorrect restore process | Verify backup integrity and use a full restore.
|
||||
3. Authentik integration issues | Incorrect OIDC settings or Authentik server downtime | Review OIDC settings and ensure proper authentication flow.
|
||||
- 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.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -124,15 +102,19 @@ To restore the mealie Stack from a backup, run `./deploy.sh`.
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-20 | 5b7ee307 | Initial documentation for mealie Stack |
|
||||
| 2026-04-19 | e9ad12cd | Updated recipe database schema |
|
||||
| 2026-04-19 | 5975ef4a | Fixed Authentik integration issues |
|
||||
| 2026-04-19 | a9f38a47 | Improved logging and monitoring for mealie Stack |
|
||||
| 2026-04-19 | 93b80043 | Enhanced security features for mealie Stack |
|
||||
| 2026-04-19 | edd41879 | Updated recipe database with new feature |
|
||||
| 2026-04-19 | 55fd7e29 | Fixed service not responding issue |
|
||||
| 2026-04-19 | bef8ba8a | Improved performance and scalability for mealie Stack |
|
||||
| 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. |
|
||||
|
||||
<Generated by Gremlin on 2026-04-20T18:15:54.217Z>
|
||||
<Source: swarm/mealie.yaml>
|
||||
<Review User Guide and Changelog sections>
|
||||
<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
|
||||
Loading…
Add table
Add a link
Reference in a new issue