HyperTrader

HyperTrader is a self-hosted copy-trading bot for Hyperliquid. Point it at a target account you trust — it watches that account, checks each move against your own risk limits, and mirrors the eligible orders to your account, scaled proportionally to your book.

You run it on your own server, so your keys never leave your machine. This guide covers the only two things you need: installing it, and using it once it is running.

Non-custodial — your account key stays on your server, never sent anywhere.
Proportional sizing — orders are scaled to your account size, not copied one-to-one.
Your rules first — every order is checked against your risk limits before it is placed.

You need a small VPS (Ubuntu), a domain name, and a few minutes. The installer handles the rest — Docker, HTTPS, and the app itself.

Install it

There are two ways to get HyperTrader running. Both give you the same result: the app, live over HTTPS, on a server you own.

Option 1 — Guided deploy (recommended)

The deploy page creates the server for you. Enter a domain and email, connect your Hetzner account, and it provisions an Ubuntu server with HTTPS configured automatically — no terminal required.

Open the deploy page →

Option 2 — One command on your own server

Already have an Ubuntu VPS? Point your domain's A record at it, then run this (swap in your own domain and email):

sudo env SSL_DOMAIN="trader.example.com" SSL_EMAIL="you@example.com" bash -c 'curl -fsSL https://raw.githubusercontent.com/htx-labs/hyper-trader-manager/main/scripts/install.sh | bash && hyper-trader-manager start'

That is all the installer needs — it sets up Docker, the app, and a Let's Encrypt certificate.

Finish setup

Once DNS resolves and the certificate is issued (usually a minute or two), open https://your-domain in a browser and create your admin account.

Admin setup only works over HTTPS — by design, so your password is never sent in the clear.

Add your first trader

A trader is one copy-trading bot: it mirrors a single target account into your account. From the dashboard, add one and give it three things:

What	Meaning
Your account key	The private key of the account that will place the mirrored orders. It is stored securely on your own server, never shown again and never sent anywhere.
Target account	The Hyperliquid address whose trades you want to mirror.
Sizing & risk	How large your mirrored orders are, and the limits that protect you — see Sizing & risk.

Save, and the trader starts watching. Mirrored fills show up live in the dashboard.

Only trade with funds you can afford to lose, and only mirror accounts you actually trust — you are placing real orders with real money.

Sizing & risk

Two settings control how HyperTrader trades on your behalf.

Size ratio

The fraction of the target's size that you mirror, scaled to your book. A ratio of 0.25 mirrors every order at 25% — so whether the target trades a small account or a large one, your orders stay proportional to your account.

Risk limits

Before any order is placed, HyperTrader checks it against your limits — for example a ceiling on projected margin usage. Orders that would breach your limits are filtered out and never reach your account, so you stay in control of your exposure.

You can change sizing and risk any time from the dashboard; changes apply to new mirrored orders going forward.

Manage & update

Day to day

From the dashboard you can start or stop a trader, watch its mirrored fills, and adjust its sizing and risk. Everything runs on your server — closing the browser does not stop the bot.

Updating

New versions ship as updated images. Update from the dashboard, or over SSH:

hyper-trader-manager update   # fetch the latest version and restart
hyper-trader-manager status   # check everything is running
hyper-trader-manager logs     # follow what the app is doing

Updates keep your traders and settings. If something looks wrong afterwards, the manager can roll back to the previous version.

Troubleshooting

The site won't load, or HTTPS isn't ready

After install it takes a minute or two for the certificate to be issued. Make sure your domain's A record points directly at the server's IP (unproxied). On Cloudflare DNS, set the record to "DNS only" (grey cloud) so the certificate can be verified.

It won't let me create an admin account

Admin setup is only available over https://, not plain http://. Wait for the certificate, then open the https:// address.

A trader isn't mirroring

Check that the trader is started, that the target account is correct, and that recent target orders actually passed your risk limits — orders that breach your limits are filtered by design. The dashboard shows each trader's status and recent activity.

Still stuck?

Ask in the community, or check that everything is running with hyper-trader-manager status and hyper-trader-manager logs.