Quick install
Requirements
- Fresh Ubuntu 24.04 VPS (2 vCPU / 4 GB RAM minimum, 8 GB recommended)
- Root SSH access
- A dedicated domain or subdomain you control (for the admin panel and tracking links)
- A Roitrack license key — get one at account.roitrack.app, or ask @roitrack on Telegram for a trial
Install command
SSH in as root, then paste:
curl -fsSL https://install.roitrack.app/install.sh | sudo bashThe installer will:
- Check the OS and install Docker, Nginx, and Certbot if missing
- Download the release files and generate secrets in
/opt/roitrack/.env - Pull the Roitrack images and start the stack
- Issue a Let’s Encrypt certificate if you supplied a domain
- Print your URL and the generated admin password
Total time: ~4 minutes on a fresh VPS.
Non-interactive install
Pass your details up front to skip the prompts. Note the = in each flag:
curl -fsSL https://install.roitrack.app/install.sh | sudo bash -s -- \| Flag | Purpose |
|---|---|
--license= | Your licence key — the tracker activates itself on first boot |
--domain= | Admin domain — also used for the certificate |
--email= | Contact address for Let’s Encrypt |
--lang= | Dashboard language, en or ru |
--version= | Install a specific version instead of the latest |
--non-interactive | Never prompt |
Your licence
The command you copy from the portal already has your key, email and language in it, so there’s nothing to enter afterwards — the tracker validates itself on first boot and comes up activated.
If you installed without a key, paste it into Settings → Updates & licence once you’re logged in. Tracking runs either way; updates are what need a valid licence. See Updating.
Verifying
Once install finishes, visit https://admin.yourdomain.com and log in with the admin password the installer printed. Save it somewhere before closing the terminal — if you lose it, reset it over SSH with reset-admin.sh.
Your license will pin to this server’s IP on first validation. If you ever need to move to a new server, unpin it from the portal first.