alphax-polymarket/deploy/README.md

Overseas VPS Deployment

This deployment keeps the dashboard bound to 127.0.0.1:8765 on the server. Access it with an SSH tunnel instead of exposing it publicly.

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

From your laptop:

ssh -L 8765:127.0.0.1:8765 user@YOUR_SERVER_IP

Then open:

http://127.0.0.1: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.