docs(gremlin): update mealie
This commit is contained in:
parent
2e19a1fe17
commit
af2635a610
1 changed files with 57 additions and 18 deletions
|
|
@ -1,26 +1,23 @@
|
||||||
---
|
---
|
||||||
title: mealie Stack
|
title: mealie Stack
|
||||||
description: Recipe Manager
|
description: Recipe Manager for NetGrimoire
|
||||||
published: true
|
published: true
|
||||||
date: 2026-04-15T23:07:29.519Z
|
date: 2026-04-15T23:13:44.661Z
|
||||||
tags: docker,swarm,mealie,netgrimoire
|
tags: docker,swarm,mealie,netgrimoire
|
||||||
editor: markdown
|
editor: markdown
|
||||||
dateCreated: 2026-04-15T23:07:29.519Z
|
dateCreated: 2026-04-15T23:13:44.661Z
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
# mealie
|
# mealie
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It includes the mealie service, which provides a web interface for managing recipes.
|
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.
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 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`, `caddy:9000`
|
||||||
- **Homepage group:** PNCHarris Apps
|
- **Homepage group:** PNCHarris Apps
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
@ -28,11 +25,12 @@ The mealie stack is a Docker Swarm-based recipe manager in NetGrimoire. It inclu
|
||||||
## Build & Configuration
|
## Build & Configuration
|
||||||
|
|
||||||
### Prerequisites
|
### Prerequisites
|
||||||
To deploy the mealie stack, you need to have Docker Swarm and Caddy installed.
|
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 docker4:docker4 /DockerVol/mealie
|
||||||
```
|
```
|
||||||
|
|
||||||
### Environment Variables
|
### Environment Variables
|
||||||
|
|
@ -73,10 +71,7 @@ docker stack services mealie
|
||||||
```
|
```
|
||||||
|
|
||||||
### First Run
|
### First Run
|
||||||
After the initial deployment, you need to run the following command to initialize the database:
|
This service does not require any specific setup after deployment.
|
||||||
```bash
|
|
||||||
./init.sh
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -84,11 +79,55 @@ After the initial deployment, you need to run the following command to initializ
|
||||||
|
|
||||||
### Accessing mealie
|
### Accessing mealie
|
||||||
| Service | URL | Purpose |
|
| Service | URL | Purpose |
|
||||||
- **Host:** `recipe.netgrimoire.com`
|
- **Recipe Manager:** `https://recipe.netgrimoire.com`
|
||||||
- **Port:** 9000 (internal) or `recipe.netgrimoire.com` (external)
|
- **Caddy Proxy:** `caddy:9000`
|
||||||
|
|
||||||
### Primary Use Cases
|
### Primary Use Cases
|
||||||
To use the mealie service, you need to sign up for an account and access the web interface.
|
To manage recipes and their associated data, navigate to the Recipe Manager service.
|
||||||
|
|
||||||
### NetGrimoire Integrations
|
### NetGrimoire Integrations
|
||||||
The mealie service connects to other services in NetGrimoire through environment variables and labels.
|
The mealie stack integrates with Authentik for OIDC authentication.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Operations
|
||||||
|
|
||||||
|
### Monitoring
|
||||||
|
```bash
|
||||||
|
docker stack services mealie
|
||||||
|
docker service logs -f mealie
|
||||||
|
```
|
||||||
|
|
||||||
|
### Backups
|
||||||
|
Critical data should be backed up on the `/DockerVol/mealie` volume.
|
||||||
|
|
||||||
|
### Restore
|
||||||
|
To restore from a backup, redeploy the `mealie-stack.yml` file using `./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.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Changelog
|
||||||
|
|
||||||
|
| 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.>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Notes
|
||||||
|
- Generated by Gremlin on 2026-04-15T23:13:44.661Z
|
||||||
|
- Source: swarm/mealie.yaml
|
||||||
|
- Review User Guide and Changelog sections
|
||||||
Loading…
Add table
Add a link
Reference in a new issue