CookDex

CookDex is a web UI for keeping a self-hosted Mealie recipe library clean, searchable, and well organized: import recipes, clean messy scraper results, keep categories and tags consistent, schedule maintenance jobs, and review library health. Every cleanup task previews its changes first.

Documentation: knownframe.com/cookdex/docs

A clean library also makes native Mealie clients better. Forked, also from Knownframe, turns your recipes into swipe-based discovery, meal plans, and one persistent shopping list on your iPhone. Its roadmap and feature requests are at Knownframe/forked-for-mealie.

Quick Start

mkdir -p cookdex && cd cookdex
curl -fsSL https://raw.githubusercontent.com/thekannen/cookdex/main/compose.ghcr.yml -o compose.yaml
docker compose pull cookdex
docker compose up -d cookdex

Open https://your-server:4820/cookdex, accept the self-signed certificate warning, and create the first admin account. Then follow Getting started.

Documentation

• Install: volumes, image tags, secrets and updating
• Getting started: first login and a first safe run
• Task reference: every task's options; see also Scheduling and automations and Safety policies
• Data maintenance · Database connection · Recipe Dredger
• Troubleshooting · Privacy and safety

For contributors: Local Dev, API routes, Providers, CONTRIBUTING.md.

Getting Help

• The Help page inside CookDex documents every task and setting in place.
• Bugs and feature requests: open an issue.

Contributing

CookDex is AGPL-3.0 and contributions are welcome. See CONTRIBUTING.md. If CookDex is useful to you, starring the repo helps other Mealie users find it.

Support

CookDex is free and built in my spare time. If it saves you time, sponsoring on GitHub helps cover hosting and the test Mealie instance every release is checked against. One-time tips are welcome too.