Quick start: your first campaign
From a bare server to your first conversion. Each step links to a detailed page.
First time with a tracker? The step-by-step guide with screenshots walks through the same path in more detail.
1. Installation
On a clean Ubuntu 22.04+ or Debian 12+ as root:
wget -O orbitra-install.sh https://raw.githubusercontent.com/fenjo26/Orbitra.link/main/install.sh && bash orbitra-install.sh
For details and requirements, see Installation and updates.
2. First login
Open http://<server-ip>/admin.php. There is no default user: the first-run wizard will ask you to create an administrator (login of at least 3 characters, password of at least 8), choose a time zone and a language.
Worth doing right away:
- enable two-factor login (β β Users β Profile);
- optionally, change the admin panel path and restrict access by IP (Administration).
3. Domain
Domains β Add domain, then point the domain's A record at the server IP. The certificate is issued automatically once DNS propagates. With Cloudflare, Namecheap, or Dynadot connected, the A record is also set automatically. β Domains and SSL
After that, it is more convenient to open the panel at https://your-domain/admin.php: Google and TikTok sign-in and the Telegram webhook only work over HTTPS.
4. Affiliate network and offer
- Affiliate networks β Add, pick a network from the templates. The template provides the Postback URL for the network's dashboard and the offer parameters (for example
&subid={subid}). - Copy the Postback URL into the network's dashboard as the global postback.
- Offers β Create: a name, the URL from the network's dashboard, the affiliate network. The network's parameters are appended to the URL automatically at click time.
A local offer (your own landing with a form) is uploaded as a ZIP archive and edited in the built-in file manager. β Traffic sources and affiliate networks, Landing pages
5. Traffic source
Sources β Add, pick an ad-network template (Facebook, TikTok, Google Adsβ¦). The template adds macros with the campaign, group, and ad IDs to the campaign URL β they are needed for cost import and statistics breakdown.
6. Campaign
Campaigns β Create:
- General: name, domain, traffic source.
- Streams: add a regular stream with the "Direct redirect to offer" schema and pick an offer. Need country or device filters β add them to the stream; need a landing β use the "Landing + Offer" schema.
- Save. Put the campaign URL (
https://your-domain/alias) into the ad.
β Campaigns and streams, Cloaking
7. Verification
- The Test link row on the "General" tab with
&_dbg=1shows which stream will fire and where the visitor will go. No click is recorded.&_geo=DEtests a different country without a VPN. - β β Postback URL β Test will send a sample conversion against a real click ID.
- The tester on the S2S Postbacks tab will verify the whole postback chain to the source.
8. Costs and notifications
- Connect an ad account under β β Integrations (Facebook, TikTok, Google Ads) so ROI is calculated from real spend. β Costs
- Connect the Telegram bot for conversion notifications. β Telegram bot
9. Statistics
Dashboard, campaign list, per-campaign report with groupings, and the full click log. β Reports, logs, and metrics
Moving from Keitaro? β Migrating from Keitaro
Quick start: your first campaign
The short path: install the tracker, create a campaign, and get your first clicks and conversions in under an hour.
Read guide βDocsInstallation and updates
Install Orbitra on a fresh Ubuntu or Debian server with one command, and update to new versions safely.
Read guide βDocsMigrating from Keitaro
Move campaigns, offers, sources and domains from Keitaro to Orbitra in one click β what transfers and what to check.
Read guide βDocsMigrating from Binom
Move campaigns and streams from Binom to Orbitra: what transfers automatically and what to set up by hand.
Read guide βDocsFeature overview
Everything Orbitra can do: campaigns and streams, cloaking, landings, PWA, postbacks, costs, reports and integrations.
Read guide βDocsCampaigns and streams
The complete reference: campaign settings, stream types, schemas, rotation, filters, test links and every option explained.
Read guide βDocsCloaking
Full cloaking reference: detection layers, global settings, per-stream filters, verdicts and reports.
Read guide βDocsBrowser check
How the JS check catches bots, VMs and emulators through contradictions in the browser environment.
Read guide βDocsLanding pages
Landing types, the {offer} macro, the JS adapter, LeadForge and multi-offer landings β the complete reference.
Read guide βDocsPWA and Web Push
Build installable PWA apps and collect push subscribers: settings, icons, events and notifications.
Read guide βDocsPWA Funnel
A multi-step PWA funnel: install prompts, event tracking and re-engagement notifications.
Read guide βDocsConversion popups
Show real conversion events as on-page popups: setup, triggers and placement.
Read guide βDocsSession recordings and heatmaps
Replay real visits and see click and scroll maps. Storage limits and privacy notes.
Read guide βDocsContent gallery
Central storage for icons, screenshots and creatives used across PWAs and landings.
Read guide βDocsCreatives library
Store creatives with subid tracking and test them across campaigns.
Read guide βDocsExternal PWA and Telegram channels
Publish PWAs to external domains and run Telegram channels as a traffic source.
Read guide βDocsPostbacks and conversions
Incoming postbacks, conversion statuses and types, and outgoing S2S postbacks to your traffic source.
Read guide βDocsCosts
Import spend from Facebook, TikTok and Google Ads, or update it via API and cron β and how the revenue aggregator works.
Read guide βDocsPush and pop networks
Working with push and pop traffic sources: feeds, zone optimization and the zone killer.
Read guide βDocsFacebook / Meta
Cost import from Meta Ads and the Conversions API: server-side events with deduplication.
Read guide βDocsDolphin / Fbtool
Receive Facebook costs through the Dolphin (Fbtool) API in real time.
Read guide βDocsFB comment cleaner
Bulk-moderate comments under Meta ads: hide, delete and filter by keywords.
Read guide βDocsTraffic sources and affiliate networks
Catalog of 50+ traffic sources and 440+ networks: templates, parameters and postback URLs.
Read guide βDocsReports, logs and metrics
The report builder, saved reports, click logs and every metric explained.
Read guide βDocsDomains and SSL
Add domains, DNS, free Let's Encrypt certificates, redirects, parking and every switch on the page.
Read guide βDocsCloudflare
How to run campaign domains through Cloudflare: DNS, SSL modes and what to turn off.
Read guide βDocsAdministration
Users, roles and permissions, security settings, geo databases, updates and system health.
Read guide βDocsTelegram bot
Manage the tracker from Telegram: stats, conversions and alerts in chat.
Read guide βDocsMCP: an AI assistant in the tracker
Connect Claude or any MCP client to Orbitra and manage campaigns with plain-language commands.
Read guide β