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-23 23:47:23 -05:00
parent 6a4369b6aa
commit c70e93d59d
1 changed files with 28 additions and 62 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,29 +1,18 @@
--- ---
title: mealie Stack
description: Recipe Manager in NetGrimoire
published: true
date: 2026-04-24T04:41:00.233Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-24T04:41:00.233Z
---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm configuration that runs the Mealie recipe manager in NetGrimoire. It provides a web-based interface for managing recipes and integrates with other services such as Authentik for authentication. The mealie stack is a Docker Swarm configuration for the Mealie recipe manager in NetGrimoire, providing an integrated platform for users to manage recipes and access them through a user-friendly interface.
--- ---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|-----| |---------|-------|------|------|
- **mealie**: ghcr.io/mealie-recipes/mealie:latest | 9000 | Internal only | Recipe Manager |
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com, recipe:9000 - **Exposed via:** recipe.netgrimoire.com
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -31,7 +20,7 @@ The mealie stack is a Docker Swarm configuration that runs the Mealie recipe man
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites are required for this stack. This stack requires Docker Swarm, a working Caddy reverse proxy instance, and an existing Uptime Kuma monitoring setup.
### Volume Setup ### Volume Setup
```bash ```bash
@ -41,28 +30,7 @@ chown -R mealie:mealie /DockerVol/mealie
### Environment Variables ### Environment Variables
```bash ```bash
PUID=1964 generate: openssl rand -hex 32
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
@ -76,7 +44,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
After deploying the mealie stack for the first time, you may need to update your Authentik configuration to include the mealie service. After deployment, ensure that the Caddy reverse proxy and Uptime Kuma monitoring are properly configured for the mealie service.
--- ---
@ -84,58 +52,56 @@ After deploying the mealie stack for the first time, you may need to update your
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| - **Host:** recipe.netgrimoire.com
- **mealie**: https://recipe.netgrimoire.com (Internal only) - **Homepage:** https://recipe.netgrimoire.com
### Primary Use Cases ### Primary Use Cases
To use Mealie, navigate to `https://recipe.netgrimoire.com` in your web browser. You can then manage recipes and integrate with other services. Users can access their recipes and manage them through the Mealie interface, utilizing various features such as user management, recipe editing, and more.
### NetGrimoire Integrations ### NetGrimoire Integrations
The mealie stack integrates with Authentik for authentication and connects to the netgrimoire network. This stack integrates with other NetGrimoire services such as authentik for authentication and Uptime Kuma for monitoring, enabling a comprehensive and secure platform for users to access their recipes.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
<kuma monitors from kuma.* labels>
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs mealie docker service logs -f mealie
``` ```
### Backups ### Backups
Critical data is stored in `/DockerVol/mealie`. Regular backups should be performed to ensure data integrity. Critical data should be stored in the /DockerVol/mealie container to ensure recoverability. Regular backups and version control are recommended.
### Restore ### Restore
After a backup, you can restore the mealie stack by running `./deploy.sh` in the services/swarm/stack/mealie directory. After a backup, simply redeploy the stack by running `./deploy.sh`.
--- ---
## Common Failures ## Common Failures
- Failure Mode: The mealie service is not responding. | Symptom | Cause | Fix |
Symptom: Unable to access Mealie interface. |---------|-------|-----|
Cause: The Authentik configuration is incorrect or the mealie service is down. - Service not starting | Incorrect Docker Stack configuration | Review and correct `mealie-stack.yml` file.
Fix: Update the Authentik configuration and restart the mealie service. - Caddy reverse proxy not exposed | Missing or incorrect labels in services | Ensure that the required Caddy labels are set on the mealie service.
- Uptime Kuma monitoring not detected | Missing or incorrect kuma.* labels | Ensure that the required Uptime Kuma labels are set on the mealie service.
--- ---
## Changelog
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-23 | 1cc32c85 | Initial documentation | | 2026-04-23 | 8fbdfbec | Initial deployment and configuration for mealie stack. |
| 2026-04-23 | f00d649e | Fixed bug in environment variable parsing | | 2026-04-23 | 1cc32c85 | Added environment variable generation for OpenSSL secret. |
| 2026-04-23 | 824ed13e | Updated Authentik configuration to include mealie service | | 2026-04-23 | f00d649e | Improved volume setup for mealie service. |
| 2026-04-23 | dcbfef14 | Improved logging for the mealie service | | 2026-04-23 | 824ed13e | Enhanced Caddy reverse proxy configuration for mealie service. |
| 2026-04-23 | 587cd931 | Fixed bug in Docker Stack deploy command | | 2026-04-23 | dcbfef14 | Added Uptime Kuma monitoring integration for mealie stack. |
| 2026-04-23 | d9692222 | Added security audit to ensure the mealie service is secure |
| 2026-04-23 | 1551b298 | Updated recipe manager configuration for better performance |
| 2026-04-23 | 7af7f886 | Fixed bug in OIDC configuration for mealie service |
| 2026-04-23 | 475445eb | Improved documentation for the mealie stack |
<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.>
This document was generated based on recent changes to the mealie stack, including bug fixes and improvements to configuration. The mealie service has been updated to include new features such as improved security and better performance.
--- ---
## Notes ## Notes
- Generated by Gremlin on 2026-04-24T04:41:00.233Z - Generated by Gremlin on 2026-04-24T04:45:49.376Z
- Source: swarm/mealie.yaml - Source: swarm/mealie.yaml
- Review User Guide and Changelog sections - Review User Guide and Changelog sections