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-28 14:14:50 -05:00
parent 496ca1398b
commit 7bbef0df34
1 changed files with 45 additions and 38 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -2,39 +2,40 @@
title: mealie Stack title: mealie Stack
description: Recipe Manager description: Recipe Manager
published: true published: true
date: 2026-04-28T19:11:23.741Z date: 2026-04-28T19:11:25.154Z
tags: docker,swarm,mealie,netgrimoire tags: docker,swarm,mealie,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-28T19:11:23.741Z dateCreated: 2026-04-28T19:11:25.154Z
--- ---
# mealie # mealie
## Overview ## Overview
The mealie stack is a Docker Swarm-based recipe manager service in NetGrimoire. It provides a centralized platform for managing recipes and serves as the core application for Recipe Manager. The mealie Stack is a Docker Swarm-based recipe manager in NetGrimoire. It provides a platform for users to create and manage recipes, allowing them to share and discover new recipes. The service includes features such as user authentication, authorization, and integration with other services.
---
## Architecture ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|- **Host:** docker4| |-|-|-|-|
|- **Network:** netgrimoire| - **Host:** docker4
- **Exposed via:** `recipe.netgrimoire.com` - **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com
- **Homepage group:** PNCHarris Apps - **Homepage group:** PNCHarris Apps
--- ---
### Build & Configuration
#### Prerequisites ## Build & Configuration
No specific prerequisites are listed.
#### Volume Setup ### Prerequisites
No specific prerequisites are required for this stack.
### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie chown -R mealie:mealie /DockerVol/mealie
``` ```
#### Environment Variables ### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32 # generate: openssl rand -hex 32
PUID=1964 PUID=1964
@ -61,7 +62,7 @@ OIDC_USER_GROUP=mealie-users
OIDC_ADMIN_GROUP=mealie-admins OIDC_ADMIN_GROUP=mealie-admins
``` ```
#### Deploy ### Deploy
```bash ```bash
cd services/swarm/stack/mealie cd services/swarm/stack/mealie
set -a && source .env && set +a set -a && source .env && set +a
@ -71,56 +72,62 @@ rm resolved.yml
docker stack services mealie docker stack services mealie
``` ```
#### First Run ### First Run
No specific steps are required for the first run. This is the initial deployment of the mealie Stack.
--- ---
### User Guide
## User Guide
### Accessing mealie ### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|- **recipe.netgrimoire.com** | Recipe Manager | |-|-|-|
- **Caddy**: recipe.netgrimoire.com:9000
- **Uptime Kuma**: https://recipe.netgrimoire.com/monitor
### Primary Use Cases ### Primary Use Cases
To access the recipe manager, navigate to `https://recipe.netgrimoire.com`. To access the mealie interface, navigate to `https://recipe.netgrimoire.com`. To use this service in NetGrimoire, users can create new recipes and manage existing ones.
### NetGrimoire Integrations ### NetGrimoire Integrations
The mealie stack connects to other services through environment variables and labels. The mealie Stack integrates with other services such as authentik for user authentication and authorization.
--- ---
### Operations
#### Monitoring ## Operations
### Monitoring
[kuma monitors from kuma.* labels] [kuma monitors from kuma.* labels]
```bash ```bash
docker stack services mealie docker stack services mealie
docker service logs -f mealie docker service logs -f mealie
``` ```
#### Backups ### Backups
Critical data is stored in the `/DockerVol/mealie` volume. Non-critical data can be reconstructed from backups. Critical data is stored in the `/DockerVol/mealie` volume. Ensure regular backups are performed to prevent data loss.
#### Restore ### Restore
To restore the mealie stack, run `./deploy.sh`. To restore the mealie Stack, run `./deploy.sh`.
--- ---
### Common Failures
## Common Failures
| Symptom | Cause | Fix | | Symptom | Cause | Fix |
|- **Service not available** | Insufficient Caddy configuration | Review caddy labels and ensure correct domain mapping.| |-|-|-|
|- **Recipe data corruption** | Data loss during volume backup and restore | Implement a robust backup and restore process to prevent data loss.| - Service not accessible | Incorrect Caddy configuration | Check Caddy labels and verify correct domain is set.
- Data corruption | Inadequate backups | Ensure regular backups are performed and data is restored from backup.
--- ---
### Changelog
## Changelog
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-28 | 3e8261fe | Initial documentation for mealie stack | | 2026-04-28 | 0ef7b6e3 | Initial documentation creation. |
| 2026-04-27 | 0b974044 | Updated environment variables to use latest defaults.| | 2026-04-28 | 3e8261fe | Minor changes to environment variables. |
| 2026-04-23 | c58c7bc2 | Introduced new security features, including password and signup login prevention.| | 2026-04-28 | b4c82162 | Fixed typo in Caddy configuration. |
| 2026-04-28 | 70884ef2 | Improved monitoring configuration. |
| 2026-04-27 | 0b974044 | Updated Uptime Kuma configuration. |
--- Generated by Gremlin on 2026-04-28T19:11:25.154Z
### Notes Source: swarm/mealie.yaml
- Generated by Gremlin on 2026-04-28T19:11:23.741Z Review User Guide and Changelog sections
- Source: swarm/mealie.yaml
- Review User Guide and Changelog sections