Skip to content

Releases: makesnosense/voice

Voice v1.0 (Self-hosted)

10 Jan 12:58
@makesnosense makesnosense
v1.0-selfhost
05ed83d

Choose a tag to compare

View all tags
Voice v1.0 (Self-hosted) Latest
Latest

Simple self-hosted version of Voice – no authentication, no database, no external services required.

Prerequisites

  • Server: Linux VPS with 1 GB RAM or more
  • Domain: Any domain pointing to your server's IP (free options: FreeDNS, DuckDNS)
  • Docker
  • Open Ports: 80 (HTTP), 443 (HTTPS), 3478 (TURN server), 49152-49172 (TURN server UDP range)

Installation

1. Clone the repository

git clone --branch v1.0-selfhost --depth 1 https://github.com/makesnosense/voice.git
cd voice

This downloads the stable self-hosted version (v1.0-selfhost) without full git history.

2. Set up environment

cp .env.selfhost.example .env
nano .env  # or use vim, micro, etc.

Edit the following in .env:

DOMAIN=your-domain.com        # your actual domain
EMAIL=your-email@example.com  # for Let's Encrypt notifications
COTURN_SECRET=                # generate with: openssl rand -base64 32

To generate a strong secret:

openssl rand -base64 32

3. Choose setup method

Option A: Quick Setup

If you don't mind using a setup script, this is the fastest way. (setup.sh is just two docker run commands)

bash setup.sh
docker compose up -d

That's it! ✨

Your voice chat is now running at https://your-domain.com

Option B: Manual Setup
1. Get SSL certificate

Load environment variables and get certificate:

source .env

docker run --rm -p 80:80 \
  -v voice_certbot-conf:/etc/letsencrypt \
  certbot/certbot certonly --standalone \
  --email ${EMAIL} \
  --agree-tos --no-eff-email --non-interactive \
  -d ${DOMAIN}

You should see: Successfully received certificate

2. Build frontend
source .env
docker run --rm \
  -v ./client:/app/client \
  -v ./shared:/app/shared \
  -v voice_client-dist:/app/dist \
  -e VITE_TURN_SERVER_HOST=${DOMAIN} \
  -e VITE_TURN_SERVER_PORT=${VITE_TURN_SERVER_PORT} \
  -w /app/client \
  node:alpine \
  sh -c "npm ci && npm run build && cp -r dist/* /app/dist/"

This takes 1-2 minutes. You should see: ✓ built in XXs

3. Start services
docker compose up -d
Assets 2
Loading