alphax-polymarket/deploy

Overseas VPS Deployment

This deployment maps the dashboard to 0.0.0.0:8765 on the server so it can be reached from outside the host. Restrict access with your cloud firewall, security group, VPN, or reverse proxy authentication.

Recommended server

• Ubuntu 22.04 or 24.04
• US East preferred, e.g. Virginia / New York / New Jersey
• 1 vCPU / 1 GB RAM is enough for observation

One-time server setup

On the remote server:

sudo bash deploy/install_ubuntu.sh

Deploy app

Copy this project to the server, then from the project root:

sudo bash deploy/install_systemd.sh
sudo systemctl start updown-dashboard
sudo systemctl status updown-dashboard

Access dashboard

Open:

http://YOUR_SERVER_IP:8765

If you prefer tunnel-only access, change docker-compose.yml back to:

ports:
  - "127.0.0.1:8765:8765"

Logs and data

docker compose logs -f
curl http://127.0.0.1:8765/api/state
curl http://127.0.0.1:8765/api/analytics
curl http://127.0.0.1:8765/api/health

Realtime observations and CLOB events are stored in data/updown.duckdb.

Compare local vs overseas

Watch these fields:

• rtds_lag_ms
• start_boundary.offset_ms
• trusted_samples / total_samples
• paper.trades
• paper.pnl
• clob_book_age_ms
• DuckDB trusted_observations

The overseas deployment is useful only if these improve materially.