White-Label Trading Platform: Complete VPS Deployment Guide

July 10, 2026 · 10 min read

This guide walks through deploying a white-label crypto trading platform on a VPS from scratch. It assumes you have the HQ Traders source code and a fresh Ubuntu 22.04/24.04 VPS.

Prerequisites

• A VPS with Ubuntu 22.04+ (4GB RAM minimum for Supabase Docker stack)
• A domain name pointed to your VPS IP
• Docker and Docker Compose installed
• Nginx installed
• Node.js 20+

Step 1: Install Docker & Docker Compose

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

Step 2: Set Up Supabase

Copy the supabase-docker/ folder from HQ Traders to your VPS:

cd /opt
# Copy the supabase-docker folder from your source code
cp -r /path/to/hqtraders/supabase-docker .

# Generate JWT secret
openssl rand -base64 32

# Edit .env with your values
nano .env

# Start Supabase
docker compose up -d

Step 3: Run Database Migrations

cd /path/to/hqtraders/main/source/supabase/migrations
# Run migrations against your local Supabase instance
# Each .sql file creates tables, indexes, and RLS policies
psql -h localhost -p 15432 -U postgres -d postgres -f 20260301000000_initial_schema.sql

Step 4: Configure Nginx

Set up nginx as reverse proxy for Supabase services and your frontend apps:

server {
    listen 443 ssl;
    server_name yourdomain.com;

    root /var/www/yourdomain;
    index index.html;

    # Supabase Auth API
    location /auth/v1/ {
        proxy_pass http://127.0.0.1:15421;
    }

    # Supabase REST API
    location /rest/v1/ {
        proxy_pass http://127.0.0.1:15421;
    }

    # Frontend SPA
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Step 5: Deploy Frontend

cd /path/to/hqtraders/main/source
npm install
# Edit .env.local with your Supabase URL and keys
npm run build
# Copy dist/ to your nginx web root
cp -r dist/* /var/www/yourdomain/

Step 6: Get SSL

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d yourdomain.com

That's it. Your platform is live. Total time: 1-3 hours for an experienced developer, under 24 hours for everyone else.