Documentation
Getting started with Velotrak
Updated 17 Nov 2026
Velotrak is a self-hosted ad tracker: one Go program on Linux, PostgreSQL for the ledger, and ClickHouse for clicks. Install with one command, create the admin in the wizard, then send traffic to a /click/ link.
What Velotrak is
Velotrak (ad tracking software at velotrak.app) records ad clicks and conversions on a server you run. It is not the Timex Velo-Trak watch. The process serves the click redirect, the admin UI, the MCP endpoint, and background jobs. PostgreSQL holds configuration and the conversion ledger. ClickHouse holds the click log used by reports.
Clicks are not metered on any plan. A license limits admin actions such as how many campaigns can be active. It does not sit on the click, postback, or CAPI delivery path. Prices and plan caps are on the licensing page and match the pricing page.
What you need
The installer runs on Linux with systemd, as root, with curl. It accepts x86_64 and arm64. On a fresh install it warns when RAM is under 3500 MB. The warning names 2 vCPU / 4 GB as the minimum. The script does not count CPUs. The site recommends 4 vCPU / 8 GB. The license does not include the server.
You can look at the admin before installing. The live demo opens with the shared account filled in. You can build campaigns there, and the site says the data resets daily.
First session
Run the installer, open the setup link it prints, and create the first admin. The wizard then checks the environment, asks for timezone and currency, and offers a license step you can skip. Currency choices in that step are USD, CNY, EUR, GBP, and JPY. The password must be at least 8 characters and at most 72 bytes.
After that, the usual chain is a traffic source, an affiliate network and offer, a flow, and a campaign on a domain. The campaign link looks like https://your-domain/click/<campaign-id>. The next pages cover installation and those objects.