67 lines
1.3 KiB
Markdown
67 lines
1.3 KiB
Markdown
# 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.
|