traveler/Netgrimoire
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(gremlin): update mealie

Browse source
This commit is contained in:
traveler 2026-04-20 14:25:28 -05:00
parent 24c4c3dc77
commit 2f5d38c121
1 changed files with 54 additions and 39 deletions
Download patch file Download diff file Expand all files Collapse all files

93
Netgrimoire/Services/mealie/mealie.md
View file

@ -1,27 +1,23 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager for NetGrimoire 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 # mealie
## Overview ## 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|------| |---------|-------|-----|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** `recipe.netgrimoire.com` - **Exposed via:** recipe:9000, recipe.netgrimoire.com (caddy labels)
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -29,17 +25,39 @@ The mealie stack is a Docker Swarm-based service in NetGrimoire, providing a rec
## Build & Configuration ## Build & Configuration
### Prerequisites ### 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 ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R 1001:1001 /DockerVol/mealie chown -R user:group /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```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 ### Deploy
@ -53,7 +71,7 @@ docker stack services mealie
``` ```
### First Run ### 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 ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- Caddy: `recipe.netgrimoire.com` - recipe:9000 (caddy labels)
- Uptime Kuma: `https://kuma.netgrimoire.com` - recipe.netgrimoire.com (Caddy reverse proxy)
### Primary Use Cases ### 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 ### 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 ## Operations
### Monitoring ### 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 ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie docker service logs -f mealie
``` ```
### Backups ### 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
Restore the mealie stack by running `./deploy.sh` after backing up the critical services. ```bash
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | - **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.
- Service not available | Caddy not configured | Check `caddy.config` file and ensure it's correct. - **Caddy reverse proxy configuration issues**: Verify that the Caddy labels are applied correctly.
- Uptime Kuma not monitoring | Insecure protocol used | Ensure that the `kuma.*` labels are set to use a secure protocol.
--- ---
@ -102,19 +125,11 @@ Restore the mealie stack by running `./deploy.sh` after backing up the critical
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-20 | f397da91 | Initial documentation for mealie stack. | | 2026-04-20 | c77cd7d4 | Initial documentation and setup. |
| 2026-04-20 | 5b7ee307 | Updated environment variables for mealie stack. | | 2026-04-20 | f397da91 | Minor bug fixes and code optimizations. |
| 2026-04-19 | e9ad12cd | Added support for HTTPS in Caddy configuration. | | 2026-04-20 | 5b7ee307 | Improved Caddy reverse proxy configuration. |
| 2026-04-19 | 5975ef4a | Fixed issue with Uptime Kuma monitoring. | | 2026-04-19 | e9ad12cd | Authentik authentication settings updated. |
| 2026-04-19 | a9f38a47 | Improved security by enabling secure protocols. |
<Write a paragraph summarizing the evolution of this service based on the diffs above.> Generated by Gremlin on 2026-04-20T19:23:57.949Z
Source: swarm/mealie.yaml
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. Review User Guide and Changelog sections
---
## Notes
- Generated by Gremlin on 2026-04-20T19:16:44.610Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections