VPS

Prerequisites

Ubuntu 22.04 or newer
Public IPv4
Domain already pointed to the VPS IP
SSH user with sudo
Base values from Environment Variables
A storage profile from Manual Installation Overview

Shared server baseline

sudo apt update && sudo apt upgrade -y
sudo timedatectl set-timezone UTC

sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw --force enable

Option A: Node.js + systemd + Nginx

Install runtime packages

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs build-essential git nginx certbot python3-certbot-nginx

Clone the repository and create .env

sudo mkdir -p /opt/kuest
sudo chown \"$USER\":\"$USER\" /opt/kuest
cd /opt/kuest
git clone https://github.com/<your-org>/prediction-market.git
cd prediction-market
cp .env.example .env

Build and migrate

npm ci
npm run build
npm run db:push

Create the systemd service and Nginx site

Set the service working directory to /opt/kuest/prediction-market, proxy Nginx to port 3000, then issue TLS with Certbot.

Option B: Docker Compose + Caddy

Install Docker Engine and Compose

Install Docker Engine, Compose plugin, and Git on the server.

Clone the repository and create .env

Use the same /opt/kuest/prediction-market layout as the Node.js path.

Set domain variables

Add:

CADDY_DOMAIN=markets.example.com
SITE_URL=https://markets.example.com

Start production compose

docker compose --env-file .env -f infra/docker/docker-compose.production.yml up -d --build

Run database migrations

docker compose --env-file .env -f infra/docker/docker-compose.production.yml exec web npm run db:push

Scheduler on VPS

If you are not using Supabase mode, create Linux cron jobs that follow Scheduled Jobs. Keep that page as the single source of truth for the exact cron expressions.

Keep only one scheduler backend active for /api/sync/*.

Owner Guide

Guided Installation

Manual Installation

Site Customization

Create Market API

Resolution API

Prerequisites

Shared server baseline

Option A: Node.js + systemd + Nginx

Option B: Docker Compose + Caddy

Scheduler on VPS

​Prerequisites

​Shared server baseline

​Option A: Node.js + systemd + Nginx

​Option B: Docker Compose + Caddy

​Scheduler on VPS

Prerequisites

Shared server baseline

Option A: Node.js + systemd + Nginx

Option B: Docker Compose + Caddy

Scheduler on VPS