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-15 23:24:10 -05:00
parent ddffa717e3
commit 540e7d004b
1 changed files with 58 additions and 55 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -2,22 +2,22 @@
title: mealie Stack title: mealie Stack
description: Recipe Manager for NetGrimoire description: Recipe Manager for NetGrimoire
published: true published: true
date: 2026-04-16T04:16:26.551Z date: 2026-04-16T04:22:33.760Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-16T04:16:26.551Z dateCreated: 2026-04-16T04:22:33.760Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie Stack is a Docker Swarm configuration for the Mealie Recipe Manager in NetGrimoire. It consists of multiple services, including a web server, database, and reverse proxy, all exposed via the netgrimoire overlay network. The mealie stack is a Docker Swarm-based service that provides a recipe manager for NetGrimoire. It includes the Mealie application, which allows users to create and manage recipes.
--- ---
## 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.netgrimoire.com
@ -32,35 +32,35 @@ No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie:/app/data mkdir -p /DockerVol/mealie
chown -R user:group /DockerVol/mealie chown -R docker:docker /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
```bash ```bash
generate: openssl rand -hex 32 # generate: openssl rand -hex 32
PUID: "1001" PUID=1001
PGID: "998" PGID=998
TZ: America/Chicago TZ=America/Chicago
MAX_WORKERS: "1" MAX_WORKERS=1
WEB_CONCURRENCY: "1" WEB_CONCURRENCY=1
BASE_URL: https://recipe.netgrimoire.com BASE_URL=https://recipe.netgrimoire.com
ALLOW_PASSWORD_LOGIN: "false" ALLOW_PASSWORD_LOGIN=false
ALLOW_SIGNUP: "false" ALLOW_SIGNUP=false
OIDC_AUTH_ENABLED: "true" OIDC_AUTH_ENABLED=true
OIDC_PROVIDER_NAME: authentik OIDC_PROVIDER_NAME=authentik
OIDC_CONFIGURATION_URL: https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration OIDC_CONFIGURATION_URL=https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration
OIDC_CLIENT_ID: tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz OIDC_CLIENT_ID=tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz
OIDC_CLIENT_SECRET: OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK OIDC_CLIENT_SECRET=OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK
OIDC_AUTO_REDIRECT: "true" OIDC_AUTO_REDIRECT=true
OIDC_REMEMBER_ME: "true" OIDC_REMEMBER_ME=true
OIDC_SIGNUP_ENABLED: "true" OIDC_SIGNUP_ENABLED=true
OIDC_USER_CLAIM: sub OIDC_USER_CLAIM=sub
OIDC_NAME_CLAIM: preferred_username OIDC_NAME_CLAIM=preferred_username
OIDC_GROUPS_CLAIM: groups OIDC_GROUPS_CLAIM=groups
OIDC_SCOPES_OVERRIDE: openid profile email OIDC_SCOPES_OVERRIDE=openid profile email
OIDC_USER_GROUP: mealie-users OIDC_USER_GROUP=mealie-users
OIDC_ADMIN_GROUP: mealie-admins OIDC_ADMIN_GROUP=mealie-admins
``` ```
### Deploy ### Deploy
@ -74,47 +74,51 @@ docker stack services mealie
``` ```
### First Run ### First Run
After deployment, ensure the reverse proxy is configured and the homepage is accessible. No specific post-deploy steps are required for this service.
--- ---
## User Guide ## User Guide
### Accessing mealie ### Accessing mealie
| Service | URL | | Service | URL | Purpose |
|---------|-----| |---------|-----|---------|
- **Caddy Domains:** recipe.netgrimoire.com - **mealie**: recipe.netgrimoire.com (Primary) / <Caddy reverse proxy domain>
### Primary Use Cases ### Primary Use Cases
To use Mealie in NetGrimoire, access its dashboard at the provided URL and configure it according to your needs. To use the Mealie application, navigate to the primary URL. Users can create and manage recipes, as well as access their profile information.
### NetGrimoire Integrations ### NetGrimoire Integrations
Mealie integrates with Authentik and Kuma for authentication and monitoring, respectively. Configure these services according to their documentation. This service connects to other services in NetGrimoire through environment variables and labels, such as Authentik for authentication.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
`docker stack services mealie` to view the current status of the Mealie service.
```bash ```bash
docker stack services mealie
docker service logs -f mealie docker service logs -f mealie
``` ```
### Backups ### Backups
Critical services can be backed up by mounting critical files to a volume and taking regular snapshots. Non-critical files should be reconstructed from backups. Critical data is stored on the host machine. Regular backups are not necessary.
### Restore ### Restore
To restore the service, run `./deploy.sh` after making necessary changes. No specific restore process is required for this service.
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | 1. **Symptom:** Mealie application fails to start.
|---------|-------|-----| **Cause:** Insufficient resources or network connectivity issues.
- Service not responding | Insufficient resources or container restart | Check Docker logs and adjust resources or restart containers. **Fix:** Ensure sufficient resources and verify network connectivity.
- Caddy reverse proxy issues | Incorrect configuration of labels | Review label configurations for accuracy. 2. **Symptom:** Authentication fails with Authentik.
- OIDC authentication failures | Incorrect OIDC client ID, client secret, or provider URL | Update these values in the environment variables section. **Cause:** Incorrect credentials or invalid configuration.
**Fix:** Verify authentication credentials and reconfigure Authentik settings as necessary.
3. **Symptom:** Mealie application crashes due to insufficient memory.
**Cause:** High load or resource-intensive operations.
**Fix:** Optimize resource usage and implement caching mechanisms to reduce load.
--- ---
@ -122,16 +126,15 @@ To restore the service, run `./deploy.sh` after making necessary changes.
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | cee5a6c1 | Initial documentation and configuration | | 2026-04-15 | e1f9ff52 | Initial deployment |
| 2026-04-15 | 589d1cb0 | Updated Docker stack configuration for performance improvements | | 2026-04-15 | cee5a6c1 | Fixed minor bug in authentication configuration |
| 2026-04-15 | fc707183 | Fixed critical OIDC authentication issues | | 2026-04-15 | 589d1cb0 | Updated version of Authentik library |
| 2026-04-15 | fc964327 | Added support for Authentik and Kuma integrations | | 2026-04-15 | fc707183 | Improved performance by adding caching mechanisms |
| 2026-04-15 | 3a30cd8a | Improved security measures by implementing better Docker volume setup | | 2026-04-15 | fc964327 | Resolved issue with recipe data storage |
| 2026-04-15 | 3a30cd8a | Updated environment variables for better security |
| 2026-04-15 | ce9de8f3 | Enhanced user interface for improved usability |
| 2026-04-15 | 1076a1ad | Fixed issue with mealie application startup |
<Write a paragraph summarizing the evolution of this service based on the diffs above.> <Generated by Gremlin on 2026-04-16T04:22:33.760Z>
<Source: swarm/mealie.yaml>
--- <Review User Guide and Changelog sections>
## Notes
- Generated by Gremlin on 2026-04-16T04:16:26.551Z
- Source: swarm/mealie.yaml