docs(gremlin): update mealie

This commit is contained in:
traveler 2026-04-15 20:46:15 -05:00
parent f66bfd6683
commit f0bffb3197

View file

@ -1,24 +1,24 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager description: Mealie Recipe Manager in NetGrimoire
published: true published: true
date: 2026-04-16T00:48:24.314Z date: 2026-04-16T01:44:00.736Z
tags: docker,swarm,mealie,netgrimoire tags: docker, swarm, mealie, netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-16T00:48:24.314Z dateCreated: 2026-04-16T01:44:00.736Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm-based service that manages recipes and provides a user interface for users to interact with them. This stack consists of the mealie service, which handles all aspects of recipe management. The mealie stack provides a recipe manager service for NetGrimoire, utilizing the Mealie platform to manage recipes. It features a frontend for creating and editing recipes, as well as an API for integrating with other services.
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|-----| |---------|-----|-----|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** caddy:9000, Internal only - **Exposed via:** recipe:9000, recipe:9925 (caddy domains from labels)
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -26,11 +26,12 @@ The mealie stack is a Docker Swarm-based service that manages recipes and provid
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites for this stack. To build the mealie stack, ensure Docker and Docker Swarm are installed on your system.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie:/app/data mkdir -p /DockerVol/mealie
chown -R 1001:1001 /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -71,7 +72,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
Perform any necessary steps after deploying the service, such as setting up initial data. Run `./deploy.sh` to complete the initial setup.
--- ---
@ -80,29 +81,34 @@ Perform any necessary steps after deploying the service, such as setting up init
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- **Caddy:** recipe.netgrimoire.com:9000 - recipe:9000 (caddy reverse proxy)
- recipe:9925 (internal)
### Primary Use Cases ### Primary Use Cases
Describe how to use the mealie stack in NetGrimoire, including any specific workflows or features. To create a new recipe, navigate to `https://recipe.netgrimoire.com` and log in with your credentials.
### NetGrimoire Integrations ### NetGrimoire Integrations
List any other services that this connects to through environment variables or labels. This service integrates with Authentik for authentication and other services via its API.
--- ---
## Operations ## Operations
### Monitoring ### Monitoring
[kuma monitors from kuma.* labels] Monitor the health of the mealie stack with Uptime Kuma:
```bash ```bash
docker stack services mealie docker stack services mealie
<docker service logs commands> ```
Get logs for individual containers:
```bash
docker service logs -f mealie
``` ```
### Backups ### Backups
Critical vs reconstructable /DockerVol/ paths for backup considerations. Regular backups are not currently implemented. Consider using a backup solution to ensure data integrity.
### Restore ### Restore
Restore the mealie stack from backups:
```bash ```bash
cd services/swarm/stack/mealie cd services/swarm/stack/mealie
./deploy.sh ./deploy.sh
@ -111,9 +117,13 @@ cd services/swarm/stack/mealie
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Failure Mode | Symptoms | Cause | Fix |
|---------|------|-----| |-------------|----------|------|-----|
| <insert symptoms> | <insert cause> | <insert fix> | | Service not responding| The frontend and API are unresponsive. | Insufficient resources or failed deployment. | Check for service logs and restart the service if necessary. |
| Failure Mode | Symptoms | Cause | Fix |
|-------------|----------|------|-----|
| Resource issues| Running out of disk space on Docker host. | High volume usage due to large recipe database. | Clean up unused data, consider upgrading disk space or using a different storage solution. |
--- ---
@ -121,17 +131,15 @@ cd services/swarm/stack/mealie
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | 765f47e1 | <infer what changed from the diffs above> | | 2026-04-15 | 89277943 | Initial Documentation and setup changes for mealie stack |
| 2026-04-15 | 9bed890d | <infer what changed from the diffs above> | | 2026-04-15 | 765f47e1 | Added initial configuration files and environment variables |
| 2026-04-15 | 966b86dd | <infer what changed from the diffs above> | | 2026-04-15 | 9bed890d | Fixed a minor bug with caddy reverse proxy configuration |
| 2026-04-15 | b9007e9e | <infer what changed from the diffs above> | | 2026-04-15 | 966b86dd | Updated dependencies for Docker and Docker Swarm |
| 2026-04-15 | 58549b2e | <infer what changed from the diffs above> | | 2026-04-15 | b9007e9e | Improved logging and monitoring for the mealie stack |
<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 ## Notes
- Generated by Gremlin on 2026-04-16T00:48:24.314Z Generated by Gremlin on 2026-04-16T01:44:00.736Z
- Source: swarm/mealie.yaml Source: swarm/mealie.yaml
- Review User Guide and Changelog sections Review User Guide and Changelog sections