Docker Deployment

Overview

The easiest way to deploy Wryft Chat is using Docker Compose.

Prerequisites

Docker 20.10+
Docker Compose 2.0+
2GB RAM minimum
10GB storage

Quick Deploy

Clone repository

git clone https://github.com/Warehouser-dev/wryft-chat.git
cd wryft-chat

Configure environment

cp backend/.env.example backend/.env
cp wryft-web/.env.example wryft-web/.env

Edit the .env files with your configuration.

Start services

docker-compose up -d

Run migrations

docker-compose exec backend psql -d wryft -f /app/migrations/*.sql

Docker Compose Services

The docker-compose.yml includes:

Backend

Rust API server
Port: 3001
Auto-restarts on failure

Frontend

Nginx serving React app
Port: 80
Gzip compression enabled

PostgreSQL

Database server
Port: 5432
Persistent volume

MinIO

S3-compatible storage
Port: 9000 (API), 9001 (Console)
Persistent volume

Redis

Cache server
Port: 6379
Optional (for performance)

Configuration

Backend Environment

DATABASE_URL=postgresql://postgres:password@postgres:5432/wryft
REDIS_URL=redis://redis:6379
S3_ENDPOINT=http://minio:9000
S3_ACCESS_KEY=minioadmin
S3_SECRET_KEY=minioadmin
S3_BUCKET=wryft
PORT=3001

Frontend Environment

VITE_API_URL=http://your-domain.com/api
VITE_WS_URL=ws://your-domain.com

Nginx Configuration

The included nginx.conf provides:

Reverse proxy to backend
WebSocket support
Gzip compression
Static file serving
CORS headers

Volumes

Persistent data is stored in:

postgres_data - Database
minio_data - File uploads
redis_data - Cache

Scaling

Horizontal Scaling

Scale backend instances:

docker-compose up -d --scale backend=3

Add load balancer (nginx/traefik) in front.

Vertical Scaling

Increase resources in docker-compose.yml:

services:
  backend:
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 2G

Monitoring

View Logs

# All services
docker-compose logs -f

# Specific service
docker-compose logs -f backend

Health Checks

# Backend health
curl http://localhost:3001/api/health

# Database
docker-compose exec postgres pg_isready

Backup

Database Backup

docker-compose exec postgres pg_dump -U postgres wryft > backup.sql

Restore Database

docker-compose exec -T postgres psql -U postgres wryft < backup.sql

MinIO Backup

docker-compose exec minio mc mirror /data/wryft /backup/wryft

Updating

# Pull latest code
git pull

# Rebuild containers
docker-compose build

# Restart services
docker-compose up -d

Troubleshooting

Container won't start

Check logs: docker-compose logs backend

Database connection failed

Verify PostgreSQL is running: docker-compose ps postgres

Out of memory

Increase Docker memory limit in Docker Desktop settings

Next Steps

Production Setup

Production deployment guide

Environment Variables

Full configuration reference

Getting Started

Features

Deployment

API Reference

Overview

Prerequisites

Quick Deploy

Docker Compose Services

Backend

Frontend

PostgreSQL

MinIO

Redis

Configuration

Backend Environment

Frontend Environment

Nginx Configuration

Volumes

Scaling

Horizontal Scaling

Vertical Scaling

Monitoring

View Logs

Health Checks

Backup

Database Backup

Restore Database

MinIO Backup

Updating

Troubleshooting

Next Steps

Production Setup

Environment Variables

​Overview

​Prerequisites

​Quick Deploy

​Docker Compose Services

​Backend

​Frontend

​PostgreSQL

​MinIO

​Redis

​Configuration

​Backend Environment

​Frontend Environment

​Nginx Configuration

​Volumes

​Scaling

​Horizontal Scaling

​Vertical Scaling

​Monitoring

​View Logs

​Health Checks

​Backup

​Database Backup

​Restore Database

​MinIO Backup

​Updating

​Troubleshooting

​Next Steps

Production Setup

Environment Variables

Overview

Prerequisites

Quick Deploy

Docker Compose Services

Backend

Frontend

PostgreSQL

MinIO

Redis

Configuration

Backend Environment

Frontend Environment

Nginx Configuration

Volumes

Scaling

Horizontal Scaling

Vertical Scaling

Monitoring

View Logs

Health Checks

Backup

Database Backup

Restore Database

MinIO Backup

Updating

Troubleshooting

Next Steps