68 lines
1.4 KiB
Markdown
68 lines
1.4 KiB
Markdown
# 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:
|
|
|
|
```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
|
|
|
|
Open:
|
|
|
|
```text
|
|
http://YOUR_SERVER_IP:8765
|
|
```
|
|
|
|
If you prefer tunnel-only access, change `docker-compose.yml` back to:
|
|
|
|
```yaml
|
|
ports:
|
|
- "127.0.0.1:8765: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.
|