Skip to main content
Run the platform locally on a single machine with Docker Compose for development and QA. This setup is not hardened for production workloads.

​
Install Git

sudo apt update -y
sudo apt install git -y

​
Clone the repository

git clone https://github.com/cometchat-team/cometchat-chat-api-infra-backend.git
cd cometchat-chat-api-infra-backend
git switch docker-swarm-setup-x86

​
Install Docker & Docker Compose (local only)

Use the included script, then verify the installation: 
./install-docker-ubuntu.sh
docker --version
docker-compose --version

​
Start the local Docker environment

docker compose pull
docker compose up -d
Result: all services required for local development start on one host.

​
Validate the local deployment

  • WebSocket Gateway: http://localhost/v1/health
  • Chat API health check: http://localhost/health

​
What this local setup includes

  • Kafka
  • Redis
  • MongoDB
  • Local Docker volumes for persistence
Intended for development, debugging, and API testing only. Do not use this environment for production traffic.