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-20 15:45:57 -05:00
parent 71ecb83c6b
commit 777e4b20e3
1 changed files with 38 additions and 42 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,33 +1,36 @@
---
title: mealie Stack
description: Recipe Manager for NetGrimoire
description: Recipe Manager
published: true
date: 2026-04-20T20:31:23.592Z
date: 2026-04-20T20:43:54.951Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-20T20:31:23.592Z
dateCreated: 2026-04-20T20:43:54.951Z
---
# mealie
## Overview
The mealie stack is a Docker Swarm service that provides a recipe manager for NetGrimoire. It consists of the mealie service, which serves as the primary interface for managing recipes, and is configured to expose its services via Caddy reverse proxy.
The mealie Stack is a Docker Swarm configuration for managing a Recipe Manager in NetGrimoire. It consists of the Mealie service, which provides a web-based interface for creating and managing recipes.
---
## Architecture
| Service | Image | Port | Role |
|---------|-----|-----|-----|
- **mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | Internal (Caddy) |
- Host: docker4
- Network: netgrimoire
- Exposed via: recipe.netgrimoire.com (via Caddy reverse proxy)
- Homepage group: PNCHarris Apps
- **Mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | / | Recipe Manager |
---
Exposed via: recipe.netgrimoire.com
Homepage group: PNCHarris Apps
---
## Build & Configuration
### Prerequisites
No prerequisites are required for this stack.
No specific prerequisites are required for this stack.
### Volume Setup
```bash
@ -73,7 +76,7 @@ docker stack services mealie
```
### First Run
Perform any necessary initial setup after deployment.
Perform any necessary initial setup, such as configuring the database or seeding the database with sample data.
---
@ -81,14 +84,11 @@ Perform any necessary initial setup after deployment.
### Accessing mealie
| Service | URL | Purpose |
|---------|-----|---------|
- **mealie:** https://recipe.netgrimoire.com (via Caddy reverse proxy) |
- **Mealie:** recipe.netgrimoire.com | Recipe Manager |
### Primary Use Cases
Please refer to the official mealie documentation for usage instructions.
### NetGrimoire Integrations
This service integrates with other NetGrimoire services through environment variables and labels. Please see the `environment` section of the `mealie-stack.yml` file for more information.
---
Primary Use Cases
This service is intended for use in managing recipes within NetGrimoire. Users can create, edit, and delete recipes, as well as manage user permissions and access control.
---
@ -97,27 +97,26 @@ This service integrates with other NetGrimoire services through environment vari
### Monitoring
```bash
docker stack services mealie
kuma monitor mealie.kuma
docker service logs mealie
```
### Backups
Critical data is stored in `/DockerVol/mealie`. Regular backups should be performed to prevent data loss.
Critical: Critical backups should be taken regularly to ensure data integrity.
Reconstructable: The database can be reconstructed from backup files if necessary.
### Restore
To restore the service, run `./deploy.sh` after a successful backup.
```bash
cd services/swarm/stack/mealie
./deploy.sh
```
---
## Common Failures
1. **Symptom:** Service does not start.
**Cause:** Insufficient resources or configuration issues.
**Fix:** Check resource allocation and ensure correct configuration in the `mealie-stack.yml` file.
2. **Symptom:** Caddy reverse proxy is not functioning correctly.
**Cause:** Incorrect configuration or network connectivity issues.
**Fix:** Verify Caddy configuration and ensure proper network connectivity to the service.
3. **Symptom:** Mealie login functionality is not working.
**Cause:** Incorrect environment variable settings or authentication configuration issues.
**Fix:** Review `environment` section of `mealie-stack.yml` file for correct settings.
| Symptom | Cause | Fix |
- **Recipe Not Found** | Database not initialized | Run `docker service logs mealie` to check for errors |
- **User Authentication Issues** | Incorrect OIDC configuration | Check and update `OIDC_CLIENT_ID` and `OIDC_CLIENT_SECRET` variables in `.env` file |
- **Recipe Import/Export Issues** | Insufficient permissions | Grant necessary permissions to users or groups using ` mealie-users` group |
---
@ -125,15 +124,12 @@ To restore the service, run `./deploy.sh` after a successful backup.
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-20 | d0e26ae6 | Initial documentation creation |
| 2026-04-20 | 47b684b0 | Configuration updates for Caddy reverse proxy |
| 2026-04-20 | c77cd7d4 | Bug fixes for environment variable settings |
| 2026-04-20 | f397da91 | Performance optimizations for mealie service |
| 2026-04-20 | 5b7ee307 | Documentation updates for NetGrimoire integrations |
| 2026-04-20 | 02a2898b | Initial documentation creation |
| 2026-04-20 | d0e26ae6 | Updated environment variables to include OIDC configuration |
| 2026-04-20 | 47b684b0 | Added first-run instructions for mealie service |
| 2026-04-20 | c77cd7d4 | Improved documentation formatting and organization |
| 2026-04-20 | f397da91 | Updated monitoring section to include Kuma monitors |
---
## Notes
- Generated by Gremlin on 2026-04-20T20:31:23.592Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections
<Generated by Gremlin on 2026-04-20T20:43:54.951Z
Source: swarm/mealie.yaml
Review User Guide and Changelog sections