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 title: mealie Stack
description: Recipe Manager for NetGrimoire description: Recipe Manager
published: true published: true
date: 2026-04-20T20:31:23.592Z date: 2026-04-20T20:43:54.951Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-20T20:31:23.592Z dateCreated: 2026-04-20T20:43:54.951Z
--- ---
# mealie # mealie
## Overview ## 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|-----| - **Mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | / | Recipe Manager |
- **mealie:** ghcr.io/mealie-recipes/mealie:latest | 9000 | Internal (Caddy) |
- Host: docker4 ---
- Network: netgrimoire Exposed via: recipe.netgrimoire.com
- Exposed via: recipe.netgrimoire.com (via Caddy reverse proxy)
- Homepage group: PNCHarris Apps Homepage group: PNCHarris Apps
--- ---
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No prerequisites are required for this stack. No specific prerequisites are required for this stack.
### Volume Setup ### Volume Setup
```bash ```bash
@ -73,7 +76,7 @@ docker stack services mealie
``` ```
### First Run ### 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 ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| - **Mealie:** recipe.netgrimoire.com | Recipe Manager |
- **mealie:** https://recipe.netgrimoire.com (via Caddy reverse proxy) |
### Primary Use Cases ---
Please refer to the official mealie documentation for usage instructions. 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.
### 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.
--- ---
@ -97,27 +97,26 @@ This service integrates with other NetGrimoire services through environment vari
### Monitoring ### Monitoring
```bash ```bash
docker stack services mealie docker stack services mealie
kuma monitor mealie.kuma docker service logs mealie
``` ```
### Backups ### 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 ### Restore
To restore the service, run `./deploy.sh` after a successful backup. ```bash
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
1. **Symptom:** Service does not start. | Symptom | Cause | Fix |
**Cause:** Insufficient resources or configuration issues. - **Recipe Not Found** | Database not initialized | Run `docker service logs mealie` to check for errors |
**Fix:** Check resource allocation and ensure correct configuration in the `mealie-stack.yml` file. - **User Authentication Issues** | Incorrect OIDC configuration | Check and update `OIDC_CLIENT_ID` and `OIDC_CLIENT_SECRET` variables in `.env` file |
2. **Symptom:** Caddy reverse proxy is not functioning correctly. - **Recipe Import/Export Issues** | Insufficient permissions | Grant necessary permissions to users or groups using ` mealie-users` group |
**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.
--- ---
@ -125,15 +124,12 @@ To restore the service, run `./deploy.sh` after a successful backup.
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-20 | d0e26ae6 | Initial documentation creation | | 2026-04-20 | 02a2898b | Initial documentation creation |
| 2026-04-20 | 47b684b0 | Configuration updates for Caddy reverse proxy | | 2026-04-20 | d0e26ae6 | Updated environment variables to include OIDC configuration |
| 2026-04-20 | c77cd7d4 | Bug fixes for environment variable settings | | 2026-04-20 | 47b684b0 | Added first-run instructions for mealie service |
| 2026-04-20 | f397da91 | Performance optimizations for mealie service | | 2026-04-20 | c77cd7d4 | Improved documentation formatting and organization |
| 2026-04-20 | 5b7ee307 | Documentation updates for NetGrimoire integrations | | 2026-04-20 | f397da91 | Updated monitoring section to include Kuma monitors |
--- <Generated by Gremlin on 2026-04-20T20:43:54.951Z
Source: swarm/mealie.yaml
## Notes Review User Guide and Changelog sections
- Generated by Gremlin on 2026-04-20T20:31:23.592Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections