How to install Velotrak on a Linux server

By Velotrak · 14 Nov 2026 · 2 min read

Velotrak installs on a Linux server with one command, run as root: curl -fsSL https://velotrak.app/install.sh | sudo bash. The installer is the same script published at that URL. It is for x86_64 and arm64, it refuses to run if you are not root or if systemd or curl is missing, and it warns when the machine has under about 4 GB of RAM. The installation guide covers the wizard, domains, TLS, and upgrades.

What you need

The marketing site lists two sizes. The floor is 2 vCPU and 4 GB, described as enough for at least 800 clicks per second (about 69 million a day). The recommended size is 4 vCPU and 8 GB. A VPS from about $10 a month is what the site quotes for the floor. The license does not include that server.

What the installer does

The script header, which you can read at velotrak.app/install.sh, describes a fresh install as three steps:

  1. If Docker is missing, it installs Docker from get.docker.com, then starts PostgreSQL and ClickHouse with Docker Compose under /opt/velotrak/stack. Those databases listen on 127.0.0.1 only, with generated passwords.
  2. It downloads the release binary for this machine from GitHub releases (velotrak/velotrak) and checks the SHA-256 against checksums.txt.
  3. It writes /opt/velotrak/velotrak.env (database URLs and a generated master key) and a systemd unit, starts the service, and waits until it answers.

Velotrak itself runs as a normal binary, not as a container. The release list is at github.com/VeloTrak/Velotrak/releases.

After it is up

The site’s setup section is five steps: install, set timezone and currency, connect traffic sources (30+ source templates and 25+ affiliate templates), build campaigns and a flow (25 condition fields), then attach CAPI. Meta, TikTok and Google CAPI are on every plan, including Free, with one account per platform on Free.

Clicks and conversions stay in the databases on this server. You can export them in full. Product telemetry is off unless you turn it on.

Upgrades and your own databases

Run the same command again to upgrade. The script keeps the previous binary as velotrak.old and leaves the env file, the passwords and the data alone.

To pin a version:

curl -fsSL https://velotrak.app/install.sh | sudo VELOTRAK_VERSION=v1.2.3 bash

Replace v1.2.3 with a tag that exists on the releases page. To bring your own PostgreSQL and ClickHouse instead of the bundled ones:

curl -fsSL https://velotrak.app/install.sh | sudo VELOTRAK_EXTERNAL_DB=1 bash

That skips Docker. You then set the database URLs in the env file. Migrations are built into the binary.

Prices, if you outgrow Free

Free is $0, with unmetered clicks, up to 3 active campaigns, and reports on the last 15 days. Pro is $49 a month or $490 a year (shown as $41/mo). Team is $99 a month or $990 a year (shown as $83/mo). None of those prices change with click volume. The pricing page lists both intervals, and the alternatives pages compare this with Voluum, RedTrack, Binom, Keitaro and BeMob using those vendors’ own pages.

Questions

Q1What server does the Velotrak installer expect?
Linux with systemd, root, and curl. The script accepts x86_64 and arm64. It warns when RAM is under about 4 GB. The site lists 2 vCPU / 4 GB as the floor and 4 vCPU / 8 GB as the recommended size.
Q2Does tracking stop if the license server cannot be reached?
No. The site says licensing is separate from the click path, with a 30-day offline grace.
Q3Where are clicks stored after install?
On that server. Unless you set VELOTRAK_EXTERNAL_DB=1, the installer starts PostgreSQL and ClickHouse and binds them to 127.0.0.1. Clicks go to ClickHouse. The ledger stays in PostgreSQL. Telemetry is off by default.

installself-hosting