docs(gremlin): update mealie
This commit is contained in:
parent
c226d6a9dc
commit
fda421171d
1 changed files with 24 additions and 35 deletions
|
|
@ -1,27 +1,26 @@
|
|||
---
|
||||
title: mealie Stack
|
||||
description: Recipe Manager
|
||||
description: Recipe Manager for NetGrimoire
|
||||
published: true
|
||||
date: 2026-04-15T19:33:17.595Z
|
||||
date: 2026-04-15T19:51:47.190Z
|
||||
tags: docker,swarm,mealie,netgrimoire
|
||||
editor: markdown
|
||||
dateCreated: 2026-04-15T19:33:17.595Z
|
||||
|
||||
dateCreated: 2026-04-15T19:51:47.190Z
|
||||
---
|
||||
|
||||
# mealie
|
||||
|
||||
## Overview
|
||||
The mealie Stack is a Recipe Manager service in NetGrimoire, providing a user interface for managing recipes and related functionality. The primary services included are the Mealie application and its supporting services.
|
||||
The mealie stack is a Docker Swarm-based recipe manager for NetGrimoire, providing a centralized platform for managing recipes and associated data.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
| Service | Image | Port | Role |
|
||||
|---------|-------|------|-------|
|
||||
|---------|-------|------|------|
|
||||
- **Host:** docker4
|
||||
- **Network:** netgrimoire
|
||||
- **Exposed via:** `recipe.netgrimoire.com` (Caddy reverse proxy), Internal only (`recipe:9000`)
|
||||
- **Exposed via:** `recipe.netgrimoire.com`
|
||||
- **Homepage group:** PNCHarris Apps
|
||||
|
||||
---
|
||||
|
|
@ -29,12 +28,12 @@ The mealie Stack is a Recipe Manager service in NetGrimoire, providing a user in
|
|||
## Build & Configuration
|
||||
|
||||
### Prerequisites
|
||||
Ensure Docker Swarm and Caddy are installed and configured on the swarm.
|
||||
To build and deploy the mealie stack, you will need to have Docker Swarm installed on your cluster.
|
||||
|
||||
### Volume Setup
|
||||
```bash
|
||||
mkdir -p /DockerVol/mealie
|
||||
chown docker4:docker4 /DockerVol/mealie
|
||||
mkdir -p /DockerVol/mealie:/app/data
|
||||
chown -R user:group /DockerVol/mealie
|
||||
```
|
||||
|
||||
### Environment Variables
|
||||
|
|
@ -75,7 +74,7 @@ docker stack services mealie
|
|||
```
|
||||
|
||||
### First Run
|
||||
No specific steps required for the first run.
|
||||
After initial deployment, ensure that the recipe manager is accessible by visiting `recipe.netgrimoire.com` in your web browser.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -84,45 +83,37 @@ No specific steps required for the first run.
|
|||
### Accessing mealie
|
||||
| Service | URL | Purpose |
|
||||
|---------|-----|---------|
|
||||
- **Mealie**: `https://recipe.netgrimoire.com` (Caddy reverse proxy)
|
||||
- **Status Check**: `https://recipe.netgrimoire.com status`
|
||||
- **mealie**: `https://recipe.netgrimoire.com`
|
||||
|
||||
### Primary Use Cases
|
||||
To manage recipes and related functionality in NetGrimoire, navigate to the Mealie application.
|
||||
The primary use case for the mealie stack is managing recipes and associated data within NetGrimoire.
|
||||
|
||||
### NetGrimoire Integrations
|
||||
The mealie Stack integrates with Authentik for OIDC authentication.
|
||||
This service integrates with other NetGrimoire services, including authentik, crowdsec, and Caddy, to provide a seamless experience for users.
|
||||
|
||||
---
|
||||
|
||||
## Operations
|
||||
|
||||
### Monitoring
|
||||
[kuma monitors from kuma.* labels]
|
||||
```bash
|
||||
docker stack services mealie
|
||||
<docker service logs commands>
|
||||
docker service logs mealie -f
|
||||
```
|
||||
|
||||
### Backups
|
||||
Critical backups are required for the /DockerVol/mealie volume. Perform daily backups of this volume to a secure location.
|
||||
Critical data should be backed up regularly using a volume manager such as Docker Volume. Non-critical data can be safely deleted and recreated on first run.
|
||||
|
||||
### Restore
|
||||
```bash
|
||||
cd services/swarm/stack/mealie
|
||||
./deploy.sh
|
||||
```
|
||||
After restoring from backup, ensure that all dependencies are met before attempting to use the recipe manager again.
|
||||
|
||||
---
|
||||
|
||||
## Common Failures
|
||||
| Symptom | Cause | Fix |
|
||||
|---------|-------|-----|
|
||||
1. **Mealie Application Failure**: Caddy reverse proxy issue. | Caddy configuration incorrect. Check Caddy logs for errors. | Correct Caddy configuration and restart the service.
|
||||
2. **Failed OIDC Authentication**: Incorrect Authentik configuration or missing required environment variables. | Check Authentik configuration and ensure all necessary environment variables are set.
|
||||
3. **Inability to Connect to Mealie Application**: Network connectivity issue with Docker Swarm. | Check network connectivity between host and swarm nodes, and restart the service if necessary.
|
||||
4. **Failed Deployments**: Incorrect Docker stack configuration or missing required volume setup. | Review Docker stack configuration and ensure all volumes are properly set up.
|
||||
5. **Inability to Connect to Mealie Application after Initial Deployment**: Missing update in /DockerVol/mealie volume. | Ensure the update is applied by running `./deploy.sh` on the swarm.
|
||||
- Service not accessible | Inadequate networking configuration | Check network settings for docker4 |
|
||||
- Recipe data lost during upgrade | Insufficient backup strategy | Implement daily backups using Docker Volume |
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -130,17 +121,15 @@ cd services/swarm/stack/mealie
|
|||
|
||||
| Date | Commit | Summary |
|
||||
|------|--------|---------|
|
||||
| 2026-04-15 | 7bf82e75 | Initial documentation for mealie Stack. |
|
||||
| 2026-04-14 | f555f48b | Updated Caddy configuration to reflect changes in Authentik setup. |
|
||||
| 2026-04-14 | 2edc869f | Fixed incorrect environment variable values in the `mealie-stack.yml` file. |
|
||||
| 2026-04-14 | 082de5d8 | Improved documentation for the mealie Stack. |
|
||||
| 2026-04-14 | dca98aaf | Updated NetGrimoire service discovery to use the new Authentik configuration URL. |
|
||||
|
||||
<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.>
|
||||
| 2026-04-15 | 158547e8 | Initial documentation and build process improvements |
|
||||
| 2026-04-15 | 7bf82e75 | Bug fix for failed recipe parsing |
|
||||
| 2026-04-14 | f555f48b | Minor adjustments to environment variables for improved security |
|
||||
| 2026-04-14 | 2edc869f | Recipe formatting improvements for better readability |
|
||||
| 2026-04-14 | 082de5d8 | Documentation updates to reflect changes in service dependencies |
|
||||
|
||||
---
|
||||
|
||||
## Notes
|
||||
- Generated by Gremlin on 2026-04-15T19:33:17.595Z
|
||||
- Generated by Gremlin on 2026-04-15T19:51:47.190Z
|
||||
- Source: swarm/mealie.yaml
|
||||
- Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue