# 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:

```bash
sudo bash deploy/install_ubuntu.sh
```

## Deploy app

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

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

## Access dashboard

From your laptop:

```bash
ssh -L 8765:127.0.0.1:8765 user@YOUR_SERVER_IP
```

Then open:

```text
http://127.0.0.1:8765
```

## Logs and data

```bash
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.