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
description: Recipe Manager for NetGrimoire
published: true
date: 2026-04-16T04:22:33.760Z
date: 2026-04-16T05:12:34.909Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-16T04:22:33.760Z
dateCreated: 2026-04-16T05:12:34.909Z
---
# mealie
## 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
| Service | Image | Port | Role |
|---------|-----|-----|-----|
|---------|-----|-----|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com
- **Exposed via:** `recipe.netgrimoire.com`
- **Homepage group:** PNCHarris Apps
---
@ -28,12 +29,12 @@ The mealie stack is a Docker Swarm-based service that provides a recipe manager
## Build & Configuration
### Prerequisites
No specific prerequisites are required for this stack.
Ensure that the necessary Docker Swarm and environment variables are set.
### Volume Setup
```bash
mkdir -p /DockerVol/mealie
chown -R docker:docker /DockerVol/mealie
chown -R 1001:1001 /DockerVol/mealie
```
### Environment Variables
@ -74,7 +75,7 @@ docker stack services mealie
```
### 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
| 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
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
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
```bash
docker stack services mealie
docker service logs -f mealie
docker service logs mealie -f
```
### Backups
Critical data is stored on the host machine. Regular backups are not necessary.
Critical: `/DockerVol/mealie` and reconstructable
### Restore
No specific restore process is required for this service.
```bash
cd services/swarm/stack/mealie
./deploy.sh
```
---
## Common Failures
1. **Symptom:** Mealie application fails to start.
**Cause:** Insufficient resources or network connectivity issues.
**Fix:** Ensure sufficient resources and verify network connectivity.
2. **Symptom:** Authentication fails with Authentik.
**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.
| Failure Mode | Symptoms | Cause | Fix |
|-------------|----------|------|-----|
- Inaccessible service | Service not responding | Incorrect environment variables or configuration issues | Check and correct environment variables and ensure proper Docker Swarm setup. |
- Unauthorized access | Unable to log in with credentials | Incorrect authentication settings | Review and update the OAuth configuration and client IDs. |
---
@ -126,15 +125,14 @@ No specific restore process is required for this service.
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-15 | e1f9ff52 | Initial deployment |
| 2026-04-15 | cee5a6c1 | Fixed minor bug in authentication configuration |
| 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 |
| 2026-04-16 | b46925df | Initial documentation creation |
| 2026-04-15 | e1f9ff52 | Updated environment variables for mealie stack |
<Generated by Gremlin on 2026-04-16T04:22:33.760Z>
<Source: swarm/mealie.yaml>
<Review User Guide and Changelog sections>
<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
- Generated by Gremlin on 2026-04-16T05:12:34.909Z
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections