docs(gremlin): update mealie
This commit is contained in:
parent
762d227a85
commit
ef47086394
1 changed files with 39 additions and 32 deletions
|
|
@ -1,26 +1,26 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Recipe Manager
|
||||
description: Recipe Manager for NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-20T02:12:01.924Z
|
||||
date: 2026-04-20T18:15:54.217Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-20T02:12:01.924Z
|
||||
dateCreated: 2026-04-20T18:15:54.217Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack is a recipe manager service in NetGrimoire, responsible for providing a platform for users to manage and share recipes.
|
||||
|
||||
---
|
||||
The mealie Stack is a Docker Swarm-based Recipe Manager for NetGrimoire, providing a centralized platform for managing and sharing recipes.
|
||||
|
||||
## Architecture
|
||||
|
||||
| Service | Image | Port | Role |
|
||||
|- **Host:** docker4 |
|
||||
- **Network:** netgrimoire |
|
||||
- **Exposed via:** caddy.netgrimoire.com, recipe:9000 |
|
||||
- **Homepage group:** PNCHarris Apps |
|
||||
|---------|-------|------|------|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** recipe.netgrimoire.com
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -32,7 +32,7 @@ No specific prerequisites are required for this stack.
|
|||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R 1964:1964 /DockerVol/mealie
|
||||
chown -R user:group /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
|
|
@ -47,7 +47,7 @@ BASE_URL=https://recipe.netgrimoire.com
|
|||
ALLOW_PASSWORD_LOGIN=false
|
||||
ALLOW_SIGNUP=false
|
||||
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_CLIENT_ID=tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz
|
||||
OIDC_CLIENT_SECRET=OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK
|
||||
|
|
@ -73,7 +73,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
After deploying, configure the OIDC provider and client IDs in the `.env` file.
|
||||
After deploying the mealie Stack, you may need to update the recipe database by running `./deploy.sh`.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -81,51 +81,58 @@ After deploying, configure the OIDC provider and client IDs in the `.env` file.
|
|||
|
||||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|- **recipe**: https://recipe.netgrimoire.com |
|
||||
|---------|-----|---------|
|
||||
- **recipe:** https://recipe.netgrimoire.com
|
||||
|
||||
### Primary Use Cases
|
||||
To access recipes, navigate to the recipe index page. To create or edit a recipe, click on the "Create Recipe" button.
|
||||
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.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
This service connects to authentik for OIDC authentication and other services through environment variables.
|
||||
The mealie Stack integrates with other services in NetGrimoire, including Authentik and Uptime Kuma.
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
Monitoring the mealie Stack is handled by Uptime Kuma, which can be accessed at kuma.mealie.netgrimoire.com.
|
||||
|
||||
```bash
|
||||
docker stack services mealie
|
||||
docker service logs -f mealie
|
||||
```
|
||||
|
||||
### Backups
|
||||
Critical data is stored in `/DockerVol/mealie`. This path should be backed up regularly to prevent data loss.
|
||||
Backups of critical data are stored in `/DockerVol/mealie`. Regular backups should be performed to ensure data integrity.
|
||||
|
||||
### Restore
|
||||
To restore the container, run `./deploy.sh` and follow the prompts.
|
||||
To restore the mealie Stack from a backup, run `./deploy.sh`.
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
| Failure Mode | Symptom | Cause | Fix |
|
||||
|- **Network issue**: Cannot connect to recipe server. | Connection timed out. | Insufficient network bandwidth or misconfigured Docker Swarm. | Check network configuration and adjust as necessary. |
|
||||
|- **Authentication failed**: Unable to authenticate with OIDC provider. | Authentication failed after retrying multiple times. | Incorrect OIDC client IDs or configuration. | Verify OIDC configuration in .env file and adjust as necessary. |
|
||||
|
||||
| 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.
|
||||
|
||||
---
|
||||
|
||||
## Changelog
|
||||
|
||||
| Date | Commit | Summary |
|
||||
|- 2026-04-19 | e9ad12cd | Initial documentation created by Gremlin on 2026-04-20T02:12:01.924Z. |
|
||||
|- 2026-04-19 | 5975ef4a | Minor adjustments to environment variables and deploy script for better security and clarity. |
|
||||
|- 2026-04-19 | a9f38a47 | Added more detailed error handling in the User Guide section. |
|
||||
|- 2026-04-19 | 93b80043 | Adjusted documentation formatting for consistency with other NetGrimoire services. |
|
||||
|- 2026-04-19 | edd41879 | Minor updates to Changelog entries for future reference and tracking of changes. |
|
||||
|------|--------|---------|
|
||||
| 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 |
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
- Generated by Gremlin on 2026-04-20T02:12:01.924Z
|
||||
- Source: swarm/mealie.yaml
|
||||
- Review User Guide and Changelog sections
|
||||
<Generated by Gremlin on 2026-04-20T18:15:54.217Z>
|
||||
<Source: swarm/mealie.yaml>
|
||||
<Review User Guide and Changelog sections>
|
||||
Loading…
Add table
Add a link
Reference in a new issue