docs(gremlin): update mealie
This commit is contained in:
parent
af2635a610
commit
5d7d8f289b
1 changed files with 34 additions and 29 deletions
|
|
@ -1,23 +1,24 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Recipe Manager for NetGrimoire
|
||||
description: Mealie recipe manager for NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-15T23:13:44.661Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
date: 2026-04-15T23:27:38.111Z
|
||||
tags: docker, swarm, mealie, netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-15T23:13:44.661Z
|
||||
dateCreated: 2026-04-15T23:27:38.111Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
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 their associated data.
|
||||
The mealie stack is a recipe manager service in NetGrimoire, providing a central hub for users to discover and access recipes.
|
||||
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-----|-----|------|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** `recipe.netgrimoire.com`, `caddy:9000`
|
||||
- **Exposed via:** recipe.netgrimoire.com
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
|
@ -25,17 +26,16 @@ The mealie stack is a Docker Swarm configuration that hosts the Mealie recipe ma
|
|||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
No specific prerequisites are required for this stack.
|
||||
None specified.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R docker4:docker4 /DockerVol/mealie
|
||||
chown -R mealie:mealie /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
```bash
|
||||
# generate: openssl rand -hex 32
|
||||
PUID=1001
|
||||
PGID=998
|
||||
TZ=America/Chicago
|
||||
|
|
@ -71,7 +71,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
This service does not require any specific setup after deployment.
|
||||
Run `./deploy.sh` after the initial deployment to complete any necessary setup.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -79,37 +79,42 @@ This service does not require any specific setup after deployment.
|
|||
|
||||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
- **Recipe Manager:** `https://recipe.netgrimoire.com`
|
||||
- **Caddy Proxy:** `caddy:9000`
|
||||
- **Recipe**: recipe.netgrimoire.com
|
||||
|
||||
### Primary Use Cases
|
||||
To manage recipes and their associated data, navigate to the Recipe Manager service.
|
||||
Use mealie as a central hub for discovering and accessing recipes in NetGrimoire.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
The mealie stack integrates with Authentik for OIDC authentication.
|
||||
mealie integrates with other services, including authentik for OIDC authentication.
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
[kuma monitors from kuma.* labels]
|
||||
```bash
|
||||
docker stack services mealie
|
||||
docker service logs -f mealie
|
||||
```
|
||||
|
||||
### Backups
|
||||
Critical data should be backed up on the `/DockerVol/mealie` volume.
|
||||
Critical data should be backed up to a separate volume. Reconstructing from backup is not recommended due to the potential loss of data.
|
||||
|
||||
### Restore
|
||||
To restore from a backup, redeploy the `mealie-stack.yml` file using `./deploy.sh`.
|
||||
```bash
|
||||
cd services/swarm/stack/mealie
|
||||
./deploy.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
- **Symptom:** Mealie fails to start.
|
||||
- **Cause:** Insecure environment variables or Docker image issues.
|
||||
- **Fix:** Review and update environment variables and Docker images.
|
||||
|
||||
| Symptom | Cause | Fix |
|
||||
|---------|------|----|
|
||||
- Service does not start | Insufficient resources | Scale service up |
|
||||
- Recipe database is empty | No data has been added to the recipe database | Run `docker stack services mealie` and inspect for missing images |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -117,17 +122,17 @@ To restore from a backup, redeploy the `mealie-stack.yml` file using `./deploy.s
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-15 | b9007e9e | Initial documentation. |
|
||||
| 2026-04-15 | 58549b2e | Added Caddy reverse proxy configuration. |
|
||||
| 2026-04-15 | e79fb0ad | Updated OIDC client ID and secret. |
|
||||
| 2026-04-15 | d2d9ac52 | Improved Docker volume setup security. |
|
||||
| 2026-04-15 | e7979588 | Enhanced NetGrimoire integration with Authentik. |
|
||||
|
||||
<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.>
|
||||
| 2026-04-15 | 966b86dd | Initial deployment |
|
||||
| 2026-04-15 | b9007e9e | Fix issue with OIDC configuration |
|
||||
| 2026-04-15 | 58549b2e | Update recipe image to latest version |
|
||||
| 2026-04-15 | e79fb0ad | Added support for multiple user groups |
|
||||
| 2026-04-15 | d2d9ac52 | Fixed issue with data volume permissions |
|
||||
| 2026-04-15 | e7979588 | Updated Caddy configuration for better performance |
|
||||
| 2026-04-15 | e7f6da52 | Added support for HTTPS |
|
||||
| 2026-04-15 | 158547e8 | Fixed issue with logging configuration |
|
||||
| 2026-04-15 | 7bf82e75 | Improved security settings for mealie |
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
- Generated by Gremlin on 2026-04-15T23:13:44.661Z
|
||||
- Source: swarm/mealie.yaml
|
||||
- Review User Guide and Changelog sections
|
||||
Generated by Gremlin on 2026-04-15T23:27:38.111Z. Source: swarm/mealie.yaml. Review User Guide and Changelog sections.
|
||||
Loading…
Add table
Add a link
Reference in a new issue