​
Welcome to Chatwoot Developer Documentation

Welcome to the complete developer documentation for Chatwoot, the open-source customer support platform trusted by thousands of businesses worldwide. Whether you’re setting up your own instance, contributing to the project, or building integrations, this documentation will guide you through every step.

​
What You’ll Find Here

Installation & Setup

Deploy Chatwoot on your infrastructure with Docker, Kubernetes, or cloud providers

Development Guide

Contribute to Chatwoot with our development setup, testing guidelines, and best practices

API Reference

Build powerful integrations with our comprehensive REST APIs

Architecture

Understand Chatwoot’s system architecture and components

​
Getting Started Paths

Choose your path based on what you want to accomplish:

​
🚀 I want to install Chatwoot

Perfect! Head to our Installation Guide to deploy Chatwoot on your preferred platform. We support:

  • Docker containers for quick setup
  • Kubernetes for scalable deployments
  • Major cloud providers (AWS, GCP, Azure)
  • Traditional Linux VMs

​
🛠️ I want to contribute to Chatwoot

Amazing! Check out our Contributing Guide to:

  • Set up your development environment
  • Understand our coding standards
  • Learn our testing practices
  • Submit your first pull request

​
🔌 I want to build integrations

Great! Explore our API Reference with three categories of APIs:

  • Application APIs - Manage accounts, agents, and conversations
  • Platform APIs - Administrative control for installations
  • Client APIs - Build custom chat interfaces

​
📚 I want to understand the architecture

Excellent! Our Architecture Guide covers:

  • System components and their interactions
  • Database schemas and relationships
  • Scalability considerations
  • Security best practices

​
Why Chatwoot?

Chatwoot is built with modern technologies and follows industry best practices:

  • Open Source: Full transparency and community-driven development
  • Multi-channel: Support customers across web, mobile, email, and social platforms
  • Scalable: From small teams to enterprise deployments
  • Extensible: Rich APIs and webhook system for custom integrations
  • Modern Stack: Ruby on Rails backend, Vue.js frontend, PostgreSQL database

​
Community & Support

Join our thriving community of developers and users:

Ready to dive in? Choose your path above and let’s build something amazing together! 🚀