Skip to main content

Local Development

Choose your preferred setup method to get Orange running on your local machine.

Choose Your Setup​

🐳 Docker Compose Setup (Recommended)​

Best for most developers. Runs all services in containers with minimal setup.

  • ⚡ Quick setup (~5 minutes)
  • 🔄 Consistent environment
  • 🚀 Production-like services
  • 📦 Easy cleanup

Go to: Docker Compose Setup Guide →

📦 DevContainer Setup​

Best for VS Code users. Fully isolated development environment with pre-configured extensions.

  • 🎯 Consistent across team
  • 🔧 Auto-configured IDE
  • 🛡️ Complete isolation
  • 👥 Great for onboarding

Go to: DevContainer Setup Guide →

💻 Native Setup​

Best for learning. Install PostgreSQL, Redis, and Python directly on your machine.

  • 🎓 Understand internals
  • ⚡ Native performance
  • 🔍 Direct system access
  • ⚙️ Full control

Go to: Native Setup Guide →

Prerequisites by Setup Type​

What You NeedDocker ComposeDevContainerNative
Docker Desktop/Engine✅ Required✅ Required❌ Not needed
VS Code⚠️ Optional✅ Required⚠️ Optional
Python 3.11+✅ Required❌ Auto-installed✅ Required
PostgreSQL❌ Auto-started❌ Auto-started✅ Manual install
Redis❌ Auto-started❌ Auto-started✅ Manual install
uv (package manager)✅ Required❌ Auto-installed✅ Required

Once you've chosen and completed your setup:

Need Help?​