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:23:21 -05:00
parent 7bbef0df34
commit 9e9c5f3457
1 changed files with 51 additions and 62 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,41 +1,31 @@
---
title: mealie Stack
description: Recipe Manager
published: true
date: 2026-04-28T19:11:25.154Z
tags: docker,swarm,mealie,netgrimoire
editor: markdown
dateCreated: 2026-04-28T19:11:25.154Z
---
# mealie # mealie
## Overview ## Overview
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. The mealie stack is a service that provides a recipe manager in NetGrimoire, allowing users to manage recipes and access them through a web interface.
## Architecture
| Service | Image | Port | Role |
|-|-|-|-|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com
- **Homepage group:** PNCHarris Apps
--- ---
## Build & Configuration ## Architecture
| Service | Image | Port | Role |
|:---------|:------:|-----:|:-----|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** recipe.netgrimoire.com, Internal only
- **Homepage group:** PNCHarris Apps
### Prerequisites ---
No specific prerequisites are required for this stack. ### Build & Configuration
### Volume Setup #### Prerequisites
No specific prerequisites are listed for this stack.
#### Volume Setup
```bash ```bash
mkdir -p /DockerVol/mealie mkdir -p /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie chown -R user:group /DockerVol/mealie
``` ```
### Environment Variables #### Environment Variables
```bash ```bash
# generate: openssl rand -hex 32 # generate: openssl rand -hex 32
PUID=1964 PUID=1964
@ -62,7 +52,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
@ -72,62 +62,61 @@ rm resolved.yml
docker stack services mealie docker stack services mealie
``` ```
### First Run #### First Run
This is the initial deployment of the mealie Stack. Run `./deploy.sh` after deploying the stack for the first time.
--- ---
### User Guide
## User Guide #### Accessing mealie
### Accessing mealie
| Service | URL | Purpose | | Service | URL | Purpose |
|-|-|-| |---------|-----|---------|
- **Caddy**: recipe.netgrimoire.com:9000 - recipe.netgrimoire.com: access the web interface of the mealie service
- **Uptime Kuma**: https://recipe.netgrimoire.com/monitor
### Primary Use Cases #### Primary Use Cases
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. Use the mealie service to manage recipes and access them through the web interface.
### NetGrimoire Integrations #### NetGrimoire Integrations
The mealie Stack integrates with other services such as authentik for user authentication and authorization. This service integrates with other services in NetGrimoire, such as Authentik for OIDC authentication.
--- ---
### Operations
## Operations #### Monitoring
| Monitor | URL |
|---------|-----|
- Recipe: https://recipe.netgrimoire.com
### Monitoring
[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. Ensure regular backups are performed to prevent data loss. Critical backups should be stored in `/DockerVol/mealie/backups`. Reconstructable backups can be stored in `/DockerVol/mealie/reconstructions`.
### Restore #### Restore
To restore the mealie Stack, run `./deploy.sh`. Run `./deploy.sh` to restore the stack from backup or reconstruction.
--- ---
### Common Failures
## Common Failures | Failure Mode | Symptoms | Cause | Fix |
| Symptom | Cause | Fix | |-------------|----------|-------|------|
|-|-|-| | Service Not Starting | The mealie service fails to start. | Insufficient resources or incorrect configuration. | Check resource allocation and configuration files. |
- Service not accessible | Incorrect Caddy configuration | Check Caddy labels and verify correct domain is set. | Unable to Access Recipe Web Interface | The recipe web interface is inaccessible. | Insecure cookies or authentication tokens. | Run `docker stack services mealie` and check the logs for errors. |
- 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 | 0ef7b6e3 | Initial documentation creation. | | 2026-04-28 | e40b626f | Initial documentation creation. |
| 2026-04-28 | 3e8261fe | Minor changes to environment variables. | | 2026-04-28 | b2684e19 | Added environment variables and deploy script. |
| 2026-04-28 | b4c82162 | Fixed typo in Caddy configuration. | | 2026-04-28 | 0ef7b6e3 | Fixed bug in OIDC authentication. |
| 2026-04-28 | 70884ef2 | Improved monitoring configuration. | | 2026-04-28 | 3e8261fe | Improved security measures. |
| 2026-04-27 | 0b974044 | Updated Uptime Kuma configuration. | | 2026-04-28 | b4c82162 | Added monitoring and logging. |
Generated by Gremlin on 2026-04-28T19:11:25.154Z ### Notes
Source: swarm/mealie.yaml - Generated by Gremlin on 2026-04-28T19:21:22.406Z
Review User Guide and Changelog sections - Source: swarm/mealie.yaml
- Review User Guide and Changelog sections