traveler/Netgrimoire
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Netgrimoire/Netgrimoire/Services/mealie/mealie.md

3.7 KiB
Raw Blame History

title description published date tags editor dateCreated
mealie Stack Mealie recipe manager true 2026-04-24T04:48:34.567Z docker,swarm,mealie,netgrimoire markdown 2026-04-24T04:48:34.567Z

mealie

Overview

The mealie stack provides a recipe manager service for NetGrimoire. It consists of the mealie service, which is responsible for managing recipes and providing a user-friendly interface.

Architecture

Service Image Port Role
  • Host: docker4
  • Network: netgrimoire
  • Exposed via: recipe.netgrimoire.com, Internal only
  • Homepage group: PNCHarris Apps

Build & Configuration

Prerequisites

Ensure you have the necessary Docker and Caddy configurations in place.

Volume Setup

mkdir -p /DockerVol/mealie
chown -R mealie:mealie /DockerVol/mealie

Environment Variables

# generate: openssl rand -hex 32
PUID=1964
PGID=1964
TZ=America/Chicago
MAX_WORKERS=1
WEB_CONCURRENCY=1
BASE_URL=https://recipe.netgrimoire.com
ALLOW_PASSWORD_LOGIN=false
ALLOW_SIGNUP=false
OIDC_AUTH_ENABLED=true
OIDC_PROVIDER_NAME=authentik
OIDC_CONFIGURATION_URL=https://auth.netgrimoire.com/application/o/mealie/.well-known/openid-configuration
OIDC_CLIENT_ID=tidMeWe3Ak30zRzcmC5vwoCqAIHXQsaVwJEp44Mz
OIDC_CLIENT_SECRET=OD0CLgELUEWGoZ8IUnduGbxhyhh4vgjMBxBAjyopNOkATWIEWSYeWRDdfY6ulX2Fj7zuUp9dpgzjoFatNviLD8E5Cv2815eDrZxH9gNb52Taur0LzqBPk25yLCvsnjXK
OIDC_AUTO_REDIRECT=true
OIDC_REMEMBER_ME=true
OIDC_SIGNUP_ENABLED=true
OIDC_USER_CLAIM=sub
OIDC_NAME_CLAIM=preferred_username
OIDC_GROUPS_CLAIM=groups
OIDC_SCOPES_OVERRIDE=openid profile email
OIDC_USER_GROUP=mealie-users
OIDC_ADMIN_GROUP=mealie-admins

Deploy

cd services/swarm/stack/mealie
set -a && source .env && set +a
docker stack config --compose-file mealie-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml mealie
rm resolved.yml
docker stack services mealie

First Run

No specific steps required for a first run.

User Guide

Accessing mealie

Service URL Purpose
  • recipe.netgrimoire.com

Primary Use Cases

Access the recipe manager service to manage recipes and provide a user-friendly interface.

NetGrimoire Integrations

This service connects to authentik for OIDC authentication.

Operations

Monitoring

docker stack services mealie
docker service logs -f mealie

Backups

Critical: Regular backups of the recipe data are necessary. The /DockerVol/mealie directory should be backed up regularly. Reconstructable: The configuration files can be rebuilt from the Docker Stack.

Restore

cd services/swarm/stack/mealie
./deploy.sh

Common Failures

Symptom Cause Fix
  • Service not accessible | Caddy not running | Restart caddy service |
  • Recipe data lost | Regular backups not executed | Execute regular backup routine |
  • Config file corrupted | Incorrect config file version | Update config file to latest version |
  • OIDC authentication issues | authentik configuration incorrect | Review and update authentik configuration |
  • Recipe management errors | Mealie configuration incorrect | Review and update mealie configuration |

Changelog

Date Commit Summary
  • 2026-04-23 | c58c7bc2 | Initial documentation creation | | 2026-04-23 | 8fbdfbec | Update Caddy reverse proxy label | | 2026-04-23 | 1cc32c85 | Update homepage description | | 2026-04-23 | f00d649e | Update NetGrimoire integrations section | | 2026-04-23 | 824ed13e | Update common failures section |

<Generated by Gremlin on 2026-04-24T04:48:34.567Z> <Source: swarm/mealie.yaml>