# Tandoor Recipe Manager

> Tandoor application for managing recipes, meal planning, and shopping lists.

- Category: Home Lab & Self-Hosting
- Difficulty: intermediate
- Components: tandoor, postgres, nginx
- Tags: tandoor, recipes, meal-planning, cooking, food
- Source: https://docker.recipes/homelab/tandoor-recipes

## Overview

Tandoor Recipe Manager is a modern, web-based recipe management platform built with Django that transforms how home cooks and professional chefs organize their culinary workflows. Originally developed to address the limitations of traditional recipe storage methods, Tandoor offers comprehensive meal planning, shopping list generation, nutritional analysis, and recipe scaling capabilities. The platform supports recipe imports from over 500+ websites and provides a collaborative environment where multiple users can share and organize recipes within households or cooking groups.

This deployment combines Tandoor's Django application with PostgreSQL for robust recipe data storage and NGINX for optimized static file serving and reverse proxy functionality. PostgreSQL's advanced JSON support perfectly complements Tandoor's complex recipe data structures, including ingredients, instructions, nutritional information, and user ratings, while maintaining ACID compliance for data integrity. NGINX handles the efficient delivery of recipe images, documents, and static assets while providing a production-ready web server layer that can handle concurrent users browsing recipes and meal plans.

Home cooking enthusiasts, meal prep professionals, and families seeking organized kitchen management will find this stack invaluable for centralizing recipe collections, planning weekly meals, and generating automated shopping lists. The combination delivers enterprise-grade reliability for recipe data with the performance needed to handle large recipe collections, multiple simultaneous users, and media-heavy content like recipe photos and cooking videos.

## Features

- Recipe import support from 500+ cooking websites including AllRecipes, Food Network, and Serious Eats with automatic ingredient parsing
- Advanced meal planning calendar with drag-and-drop recipe scheduling and automatic shopping list generation
- PostgreSQL-powered recipe scaling and nutritional calculation with precise ingredient ratio mathematics
- Multi-user recipe sharing with customizable permissions for family members and cooking groups
- NGINX-optimized recipe image and document storage with efficient caching for faster page loads
- Recipe rating and review system with PostgreSQL full-text search across ingredients and instructions
- Automated shopping list consolidation that combines ingredients across multiple planned meals
- Recipe versioning and modification tracking using PostgreSQL's transaction logging capabilities

## Use cases

- Family meal planning with shared recipe collections and coordinated shopping lists across household members
- Professional meal prep businesses managing client recipes, nutritional requirements, and bulk ingredient purchasing
- Cooking enthusiasts digitizing and organizing large physical recipe collections with searchable metadata
- Diet-conscious individuals tracking nutritional information and scaling recipes for specific caloric goals
- Cooking content creators managing recipe development workflows and sharing test recipes with beta users
- Restaurant R&D teams collaborating on menu development and recipe standardization processes
- Cooking clubs and community groups sharing seasonal recipes and organizing group meal planning events

## Prerequisites

- Minimum 2GB RAM to handle PostgreSQL recipe database and NGINX concurrent connections during peak usage
- Port 8080 available for NGINX web interface access and recipe browsing
- Docker host with at least 10GB free storage for recipe images, documents, and PostgreSQL data growth
- Basic understanding of Django application management for creating superuser accounts and user administration
- NGINX reverse proxy configuration knowledge for customizing static file serving and caching policies
- PostgreSQL backup strategy familiarity to protect recipe collections and user data

## docker-compose.yml

```yaml
services:
  tandoor:
    image: vabene1111/recipes:latest
    container_name: tandoor
    environment:
      - SECRET_KEY=${SECRET_KEY}
      - DB_ENGINE=django.db.backends.postgresql
      - POSTGRES_HOST=postgres
      - POSTGRES_PORT=5432
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=tandoor
      - ENABLE_SIGNUP=1
    volumes:
      - tandoor_static:/opt/recipes/staticfiles
      - tandoor_media:/opt/recipes/mediafiles
    depends_on:
      - postgres
    networks:
      - tandoor-network

  nginx:
    image: nginx:alpine
    container_name: tandoor-nginx
    volumes:
      - tandoor_static:/static:ro
      - tandoor_media:/media:ro
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    ports:
      - "8080:80"
    depends_on:
      - tandoor
    networks:
      - tandoor-network

  postgres:
    image: postgres:16-alpine
    container_name: tandoor-db
    environment:
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=tandoor
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - tandoor-network

volumes:
  tandoor_static:
  tandoor_media:
  postgres_data:

networks:
  tandoor-network:
    driver: bridge
```

## .env

```bash
# Tandoor
SECRET_KEY=your-secret-key-at-least-50-chars
POSTGRES_USER=tandoor
POSTGRES_PASSWORD=tandoor_password
```

## Usage notes

- UI at http://localhost:8080
- Create nginx.conf for reverse proxy
- Create superuser via manage.py
- Import from various recipe sites
- Multiple user support

## Troubleshooting

- Tandoor static files not loading: Verify NGINX volume mounts for tandoor_static and tandoor_media are properly configured in nginx.conf
- Recipe import failing from websites: Check Tandoor container logs for SSL certificate issues and ensure outbound HTTPS connectivity
- PostgreSQL connection refused errors: Confirm POSTGRES_HOST environment variable matches the postgres service name in docker-compose
- NGINX 502 Bad Gateway when accessing recipes: Ensure Tandoor container is fully initialized by checking Django migration completion in logs
- Recipe images not displaying: Verify tandoor_media volume permissions and check that NGINX has read access to media files
- Slow recipe search performance: Monitor PostgreSQL container memory usage and consider increasing shared_buffers for better full-text search performance

