VSpeak

Self-hosted voice & text communication platform with WebRTC

Deployment

Prerequisites

• Docker & Docker Compose
• SSL certificates for your domain (required for HTTPS, which browsers enforce for microphone/camera access)

Setup

1. Create .env.prod from the example and fill in all empty values:

   cp .env.prod.example .env.prod

2. Start:

   docker compose --env-file .env.prod up -d

Updates

git pull && docker compose --env-file .env.prod pull && docker compose --env-file .env.prod up -d && docker compose --env-file .env.prod restart nginx

Development

Requires Docker for local infrastructure (PostgreSQL + MinIO).

# Install dependencies
pnpm install

# Start local infrastructure (PostgreSQL + MinIO)
pnpm infra:up

# Development (all services in parallel)
pnpm dev

# Development (separate terminals)
pnpm dev:server   # Backend on :3000
pnpm dev:client   # Frontend on :5173

# Build
pnpm build

# Lint
pnpm lint
pnpm lint:fix

Configure local environment in server/.env.local if it needs to be changed.