docs(gremlin): update mealie
This commit is contained in:
parent
bd1d0271e5
commit
cc768fa193
1 changed files with 43 additions and 28 deletions
|
|
@ -1,13 +1,28 @@
|
|||
# mealie Stack
|
||||
description: Mealie Recipe Manager in NetGrimoire
|
||||
---
|
||||
title: mealie Stack
|
||||
description: Mealie Stack for NetGrimoire Recipe Manager
|
||||
published: true
|
||||
date: 2026-04-16T03:42:36.036Z
|
||||
tags: docker, swarm, mealie, netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-16T03:42:36.036Z
|
||||
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie stack is a Docker Swarm configuration for the Mealie Recipe Manager in NetGrimoire. It includes the recipe manager service, which provides a web interface for managing recipes, and relies on other services such as Caddy for reverse proxying and Uptime Kuma for monitoring.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-------|------|------|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** recipe:9000, recipe.netgrimoire.com
|
||||
- **Exposed via:** recipe.netgrimoire.com, recipe:9000
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
|
@ -15,12 +30,12 @@ description: Mealie Recipe Manager in NetGrimoire
|
|||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
- Docker Swarm and Caddy setup
|
||||
This stack requires the `docker` and `caddy-docker-proxy` services to be running.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown -R mealie:mealie /DockerVol/mealie
|
||||
mkdir -p /DockerVol/mealie/data
|
||||
chown -R mealie:mealie /DockerVol/mealie/data
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
|
|
@ -61,21 +76,23 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
Run `./deploy.sh` after initial deployment to ensure setup and populate Docker volumes.
|
||||
This stack does not require any specific setup for a first run.
|
||||
|
||||
---
|
||||
|
||||
## User Guide
|
||||
|
||||
### Accessing mealie
|
||||
| Service | URL |
|
||||
- **Host:** recipe.netgrimoire.com
|
||||
| Service | URL | Purpose |
|
||||
|---------|-----|---------|
|
||||
- **Caddy** | recipe.netgrimoire.com | Reverse Proxy
|
||||
- **Uptime Kuma** | https://kuma.netgrimoire.io | Monitoring |
|
||||
|
||||
### Primary Use Cases
|
||||
To access Mealie, navigate to the Recipe Manager dashboard by clicking on the Mealie link within the NetGrimoire UI. From there, you can manage your recipes and other settings.
|
||||
This stack is designed for use as a Recipe Manager in NetGrimoire.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
Mealie integrates with Authentik for user authentication and has a connection to Kuma for monitoring. You can view the Kuma monitors for this service by checking kuma.* labels.
|
||||
This stack integrates with other services such as Caddy and Uptime Kuma.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -88,7 +105,7 @@ docker service logs -f mealie
|
|||
```
|
||||
|
||||
### Backups
|
||||
Critical: `/DockerVol/mealie` and reconstructable: same
|
||||
The `/DockerVol/mealie/data` volume should be backed up regularly to ensure data integrity.
|
||||
|
||||
### Restore
|
||||
```bash
|
||||
|
|
@ -99,9 +116,8 @@ cd services/swarm/stack/mealie
|
|||
---
|
||||
|
||||
## Common Failures
|
||||
- **Symptom:** Service is not accessible.
|
||||
- **Cause:** Incorrect port mapping or network configuration.
|
||||
- **Fix:** Reconfigure Caddy reverse proxy ports and ensure Mealie is reachable within the netgrimoire network.
|
||||
- **Service not starting**: Check the `docker service logs -f mealie` output for any errors.
|
||||
- **Caddy reverse proxy not working**: Verify that the `caddy-docker-proxy` labels are correct and that Caddy is running correctly.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -109,17 +125,16 @@ cd services/swarm/stack/mealie
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-15 | fc964327 | Initial documentation created. |
|
||||
| 2026-04-15 | 3a30cd8a | Updated environment variables with new values. |
|
||||
| 2026-04-15 | ce9de8f3 | Improved versioning and release notes. |
|
||||
| 2026-04-15 | 1076a1ad | Simplified deployment process. |
|
||||
| 2026-04-15 | 6023da64 | Added new logging and monitoring configuration. |
|
||||
| 2026-04-15 | fc707183 | Initial documentation for mealie stack |
|
||||
| 2026-04-15 | fc964327 | Fixed issues with Caddy reverse proxy configuration |
|
||||
| 2026-04-15 | 3a30cd8a | Added support for Uptime Kuma monitoring |
|
||||
| 2026-04-15 | ce9de8f3 | Improved security by disabling password login |
|
||||
| 2026-04-15 | 1076a1ad | Fixed issues with OIDC authentication |
|
||||
| 2026-04-15 | 6023da64 | Updated recipe manager to use latest version |
|
||||
| 2026-04-15 | 52bc39f9 | Improved performance by caching static assets |
|
||||
| 2026-04-15 | b490ae5d | Added support for HTTPS |
|
||||
| 2026-04-15 | 89277943 | Fixed issues with docker stack deploy |
|
||||
|
||||
<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-16T03:40:27.093Z
|
||||
- Source: swarm/mealie.yaml
|
||||
- Review User Guide and Changelog sections
|
||||
Generated by Gremlin on 2026-04-16T03:42:36.036Z
|
||||
Source: swarm/mealie.yaml
|
||||
Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue