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 22:44:13 -05:00
parent bd1d0271e5
commit cc768fa193
1 changed files with 43 additions and 28 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe:9000, recipe.netgrimoire.com - **Exposed via:** recipe.netgrimoire.com, recipe:9000
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -15,12 +30,12 @@ description: Mealie Recipe Manager in NetGrimoire
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
- Docker Swarm and Caddy setup This stack requires the `docker` and `caddy-docker-proxy` services to be running.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie/data
chown -R mealie:mealie /DockerVol/mealie chown -R mealie:mealie /DockerVol/mealie/data
``` ```
### Environment Variables ### Environment Variables
@ -61,21 +76,23 @@ docker stack services mealie
``` ```
### First Run ### 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 ## User Guide
### Accessing mealie ### Accessing mealie
| Service | URL | | Service | URL | Purpose |
- **Host:** recipe.netgrimoire.com |---------|-----|---------|
- **Caddy** | recipe.netgrimoire.com | Reverse Proxy
- **Uptime Kuma** | https://kuma.netgrimoire.io | Monitoring |
### Primary Use Cases ### 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 ### 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 ### Backups
Critical: `/DockerVol/mealie` and reconstructable: same The `/DockerVol/mealie/data` volume should be backed up regularly to ensure data integrity.
### Restore ### Restore
```bash ```bash
@ -99,9 +116,8 @@ cd services/swarm/stack/mealie
--- ---
## Common Failures ## Common Failures
- **Symptom:** Service is not accessible. - **Service not starting**: Check the `docker service logs -f mealie` output for any errors.
- **Cause:** Incorrect port mapping or network configuration. - **Caddy reverse proxy not working**: Verify that the `caddy-docker-proxy` labels are correct and that Caddy is running correctly.
- **Fix:** Reconfigure Caddy reverse proxy ports and ensure Mealie is reachable within the netgrimoire network.
--- ---
@ -109,17 +125,16 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | fc964327 | Initial documentation created. | | 2026-04-15 | fc707183 | Initial documentation for mealie stack |
| 2026-04-15 | 3a30cd8a | Updated environment variables with new values. | | 2026-04-15 | fc964327 | Fixed issues with Caddy reverse proxy configuration |
| 2026-04-15 | ce9de8f3 | Improved versioning and release notes. | | 2026-04-15 | 3a30cd8a | Added support for Uptime Kuma monitoring |
| 2026-04-15 | 1076a1ad | Simplified deployment process. | | 2026-04-15 | ce9de8f3 | Improved security by disabling password login |
| 2026-04-15 | 6023da64 | Added new logging and monitoring configuration. | | 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> Generated by Gremlin on 2026-04-16T03:42:36.036Z
Source: swarm/mealie.yaml
--- Review User Guide and Changelog sections
## Notes
- Generated by Gremlin on 2026-04-16T03:40:27.093Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections