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-16 00:14:05 -05:00
parent 540e7d004b
commit dbf56dc120
1 changed files with 32 additions and 34 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,26 +1,27 @@
--- ---
title: mealie Stack title: mealie Stack
description: Recipe Manager for NetGrimoire description: Recipe Manager for NetGrimoire
published: true published: true
date: 2026-04-16T04:22:33.760Z date: 2026-04-16T05:12:34.909Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-16T04:22:33.760Z dateCreated: 2026-04-16T05:12:34.909Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm-based service that provides a recipe manager for NetGrimoire. It includes the Mealie application, which allows users to create and manage recipes. The mealie stack is a Recipe Manager service for NetGrimoire. It provides features such as recipe listing and management.
--- ---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|-----| |---------|-----|-----|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com - **Exposed via:** `recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
@ -28,12 +29,12 @@ The mealie stack is a Docker Swarm-based service that provides a recipe manager
## Build & Configuration ## Build & Configuration
### Prerequisites ### Prerequisites
No specific prerequisites are required for this stack. Ensure that the necessary Docker Swarm and environment variables are set.
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R docker:docker /DockerVol/mealie chown -R 1001:1001 /DockerVol/mealie
``` ```
### Environment Variables ### Environment Variables
@ -74,7 +75,7 @@ docker stack services mealie
``` ```
### First Run ### First Run
No specific post-deploy steps are required for this service. After the initial deployment, verify that the service is accessible and running.
--- ---
@ -83,13 +84,13 @@ No specific post-deploy steps are required for this service.
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- **mealie**: recipe.netgrimoire.com (Primary) / <Caddy reverse proxy domain> - **Recipe Manager** | `recipe.netgrimoire.com` | Access recipes and management interface
### Primary Use Cases ### Primary Use Cases
To use the Mealie application, navigate to the primary URL. Users can create and manage recipes, as well as access their profile information. Use this service to manage recipes in NetGrimoire.
### NetGrimoire Integrations ### NetGrimoire Integrations
This service connects to other services in NetGrimoire through environment variables and labels, such as Authentik for authentication. This service integrates with authentik for OAuth authentication.
--- ---
@ -98,27 +99,25 @@ This service connects to other services in NetGrimoire through environment varia
### Monitoring ### Monitoring
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie docker service logs mealie -f
``` ```
### Backups ### Backups
Critical data is stored on the host machine. Regular backups are not necessary. Critical: `/DockerVol/mealie` and reconstructable
### Restore ### Restore
No specific restore process is required for this service. ```bash
cd services/swarm/stack/mealie
./deploy.sh
```
--- ---
## Common Failures ## Common Failures
1. **Symptom:** Mealie application fails to start. | Failure Mode | Symptoms | Cause | Fix |
**Cause:** Insufficient resources or network connectivity issues. |-------------|----------|------|-----|
**Fix:** Ensure sufficient resources and verify network connectivity. - Inaccessible service | Service not responding | Incorrect environment variables or configuration issues | Check and correct environment variables and ensure proper Docker Swarm setup. |
2. **Symptom:** Authentication fails with Authentik. - Unauthorized access | Unable to log in with credentials | Incorrect authentication settings | Review and update the OAuth configuration and client IDs. |
**Cause:** Incorrect credentials or invalid configuration.
**Fix:** Verify authentication credentials and reconfigure Authentik settings as necessary.
3. **Symptom:** Mealie application crashes due to insufficient memory.
**Cause:** High load or resource-intensive operations.
**Fix:** Optimize resource usage and implement caching mechanisms to reduce load.
--- ---
@ -126,15 +125,14 @@ No specific restore process is required for this service.
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-15 | e1f9ff52 | Initial deployment | | 2026-04-16 | b46925df | Initial documentation creation |
| 2026-04-15 | cee5a6c1 | Fixed minor bug in authentication configuration | | 2026-04-15 | e1f9ff52 | Updated environment variables for mealie stack |
| 2026-04-15 | 589d1cb0 | Updated version of Authentik library |
| 2026-04-15 | fc707183 | Improved performance by adding caching mechanisms |
| 2026-04-15 | fc964327 | Resolved issue with recipe data storage |
| 2026-04-15 | 3a30cd8a | Updated environment variables for better security |
| 2026-04-15 | ce9de8f3 | Enhanced user interface for improved usability |
| 2026-04-15 | 1076a1ad | Fixed issue with mealie application startup |
<Generated by Gremlin on 2026-04-16T04:22:33.760Z> <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.>
<Source: swarm/mealie.yaml>
<Review User Guide and Changelog sections> ---
## Notes
- Generated by Gremlin on 2026-04-16T05:12:34.909Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections