Docs

Administration

Everything opened from the βš™ menu in the panel's top right corner.

Users and access

βš™ β†’ Users. Two tabs: Users (the accounts table, visible to admins) and Profile (your own account β€” for every user).

Roles

There are two roles: admin (full access) and user (per-resource permissions). The account created at installation cannot be deleted, nor can the last remaining admin. Users have permission templates: media buyer, video editor / designer, developer, or custom permissions.

Permissions are granted per resource: campaigns, offers, landings, sources, affiliate networks, domains, logs, gallery, push. Levels are full, read-only, no access. For campaigns there are also own + assigned and assigned only β€” then the user sees and edits only those campaigns everywhere: in lists, reports, logs, conversions, on the dashboard. Financial data can be hidden separately: costs, revenue, payouts.

Permissions are enforced on the server. Actions not assigned to any resource are admin-only (full list in REST API). Globally dangerous operations (clearing statistics, Keitaro import, conversion import, retro-remapping) are unavailable to users with "own + assigned" access.

Profile

Login, email, interface language, time zone (about 250 zones with the current UTC offset), first day of the week, password change (requires the current password; minimum 8 characters).

Two-factor authentication β€” TOTP via an authenticator app. Codes are one-time.

API keys

Created by an admin for a user: read β€” read-only, write β€” also management. The key is passed in the Authorization: Bearer <key> header or X-Api-Key. Used in MCP, REST API, receiving costs from Dolphin / Fbtool, and the Ads Manager extension.

Sign-in

Failed-attempt limits: 5 per 5 minutes from one IP, and 20 per 15 minutes per account (reset after a successful sign-in). Session lifetime is session_lifetime (a day by default, from 5 minutes to 30 days; the ORBITRA_SESSION_LIFETIME environment variable takes priority over the setting).

Settings

βš™ β†’ Settings, tabs:

TabWhat's there
GeneralPostback key, default currency, manual server IP, PHP landings permission (off by default) and their 1–9 s timeout
BotsBrowser check mode (Off / Observe only / Soft / Strict), bot IPs and signatures, the global Bot ISP list, datacenter ranges, VPN ASN as a bot signal β€” see Cloaking
Conversion typesCustom statuses and what they mean, unmapped statuses β€” see Postbacks
Custom metricsCustom formulas for reports
AutomationCrons: postback queue, backorder
SystemStatistics collection on/off, ignore prefetch, new version checks, log and archive retention periods, panel access by IP/subnets, admin panel path
PrivacyScan protection: what to answer when a working link is hit directly without campaign parameters β€” a 302 to your URL, 404, or an empty page

Panel path

/admin.php is the first thing any scanner checks. In System β†’ Admin panel path you can replace it with your own (/my-panel), after which /admin.php starts answering 404. This hides the login form but does not replace the password. If the path is forgotten:

php /var/www/orbitra/cli/admin_path.php          # print the current path
php /var/www/orbitra/cli/admin_path.php reset    # Π²Π΅Ρ€Π½ΡƒΡ‚ΡŒ /admin.php

Panel access by IP

A list of IPs and subnets (IPv4 and IPv6, one per line). Empty β€” the panel is available from anywhere. Filled β€” signing in to the panel and authorized api.php calls work only from those addresses. X-Forwarded-For headers are trusted by the tracker only from Cloudflare and private proxies. Careful: you can lock yourself out. To lift the restriction from the server:

sudo -u www-data php -r '$db = new PDO("sqlite:/var/www/orbitra/orbitra_db.sqlite"); $db->exec("UPDATE settings SET value = \x27\x27 WHERE key = \x27admin_ip_access\x27");'

Retention periods

The "Log retention period" and "Archive resource retention period" fields only work when the cleanup cron is running. The installer does not set it up β€” add it manually:

0 3 * * * php /var/www/orbitra/cli/cleanup_cron.php >> /var/www/orbitra/var/logs/cleanup.log 2>&1

Deletion runs in batches so the database is not blocked.

Personalization

βš™ β†’ Personalization β€” logo, name, light or dark theme and palettes: Cobalt, Canary, Parchment, Indigo (in light and dark variants), Terminal, Aurora. The theme is applied before the first paint, so the dark theme is dark from the very first frame.

The interface language is in the profile: English, Русский, Π£ΠΊΡ€Π°Ρ—Π½ΡΡŒΠΊΠ°, EspaΓ±ol, Deutsch, FranΓ§ais, δΈ­ζ–‡.

Geo databases

βš™ β†’ Geo Databases. Without a geo database, country filters and country cloaking do not work (all visitors are Unknown); without an ASN database β€” the datacenter and ISP list layers.

DatabaseKeyProvides
Sypex Geo Citynot neededCountry, region, city. Installed by the installer
MaxMind GeoLite2 City / ASNMaxMind license keyCity, ASN and provider
IP2Location DB11IP2Location tokenGeo, time zone
IP2Proxy PX12IP2Location tokenVPN, proxy, TOR, residential, fraud score

The databases are updated monthly by the cli/geo_update.php cron (tagged # orbitra-geo; MaxMind and IP2 β€” only if keys are saved). A panel update installs Sypex by itself when there are no databases at all. A banner on all tabs warns when there are no databases or only Sypex.

βš™ β†’ Geo profiles β€” ready-made country sets for filters (EU, CIS, etc.) and custom ones.

Update

βš™ β†’ Update β€” checks for a new version on GitHub and updates with a button (git pull as the web user). The check is cached for an hour, for 10 minutes on error; disabled in System β†’ Notify about new versions.

After an update the panel by itself:

Changes that need root (sudo rules, SSL helpers) cannot be done by the button β€” the panel shows a banner with the cli/server_setup.sh command (Deployment).

If exec is disabled on the hosting, the page shows commands for manual updating via Git.

Misc

Menu itemWhat it does
ArchiveDeleted campaigns, offers, landings, sources, affiliate networks: restore or erase forever
Clear statisticsDelete clicks and conversions for a period or all of them
MigrationsDatabase schema version, Keitaro import (Keitaro Migration)
StatusDisk, CPU, RAM, database size
LogsTraffic, postbacks, S2S, system, audit (Reports and logs)
GalleryMedia library for PWA, landings and offers (Content Gallery)
AI / MCPConnecting an AI assistant (MCP)
Support and feedbackContacts and the partners block

Ads Manager extension

An extension for Chrome and Chromium-based antidetect browsers shows Orbitra metrics next to campaign, ad group and ad rows in Facebook Ads Manager (refreshing every 30 seconds), and on click β€” a three-day breakdown: daily history, landings and offers, Pixel / CAPI delivery accuracy.

  1. βš™ β†’ Integrations β†’ Chrome & Antidetect Extension β€” download the archive and unpack it.
  2. Load the folder as an unpacked extension (or a ZIP, where supported).
  3. In the extension popup, paste the tracker URL and the highlighted read key Orbitra shows.

The extension only needs a read key. Safe hits are excluded the same way as in reports.

← Previous
Cloudflare
Next β†’
Telegram bot
View source on GitHub: github.com/fenjo26/Orbitra.link/wiki
All guides
Docs

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 β†’
Docs

Installation and updates

Install Orbitra on a fresh Ubuntu or Debian server with one command, and update to new versions safely.

Read guide β†’
Docs

Migrating from Keitaro

Move campaigns, offers, sources and domains from Keitaro to Orbitra in one click β€” what transfers and what to check.

Read guide β†’
Docs

Migrating from Binom

Move campaigns and streams from Binom to Orbitra: what transfers automatically and what to set up by hand.

Read guide β†’
Docs

Feature overview

Everything Orbitra can do: campaigns and streams, cloaking, landings, PWA, postbacks, costs, reports and integrations.

Read guide β†’
Docs

Campaigns and streams

The complete reference: campaign settings, stream types, schemas, rotation, filters, test links and every option explained.

Read guide β†’
Docs

Cloaking

Full cloaking reference: detection layers, global settings, per-stream filters, verdicts and reports.

Read guide β†’
Docs

Browser check

How the JS check catches bots, VMs and emulators through contradictions in the browser environment.

Read guide β†’
Docs

Landing pages

Landing types, the {offer} macro, the JS adapter, LeadForge and multi-offer landings β€” the complete reference.

Read guide β†’
Docs

PWA and Web Push

Build installable PWA apps and collect push subscribers: settings, icons, events and notifications.

Read guide β†’
Docs

PWA Funnel

A multi-step PWA funnel: install prompts, event tracking and re-engagement notifications.

Read guide β†’
Docs

Conversion popups

Show real conversion events as on-page popups: setup, triggers and placement.

Read guide β†’
Docs

Session recordings and heatmaps

Replay real visits and see click and scroll maps. Storage limits and privacy notes.

Read guide β†’
Docs

Content gallery

Central storage for icons, screenshots and creatives used across PWAs and landings.

Read guide β†’
Docs

Creatives library

Store creatives with subid tracking and test them across campaigns.

Read guide β†’
Docs

External PWA and Telegram channels

Publish PWAs to external domains and run Telegram channels as a traffic source.

Read guide β†’
Docs

Postbacks and conversions

Incoming postbacks, conversion statuses and types, and outgoing S2S postbacks to your traffic source.

Read guide β†’
Docs

Costs

Import spend from Facebook, TikTok and Google Ads, or update it via API and cron β€” and how the revenue aggregator works.

Read guide β†’
Docs

Push and pop networks

Working with push and pop traffic sources: feeds, zone optimization and the zone killer.

Read guide β†’
Docs

Facebook / Meta

Cost import from Meta Ads and the Conversions API: server-side events with deduplication.

Read guide β†’
Docs

Dolphin / Fbtool

Receive Facebook costs through the Dolphin (Fbtool) API in real time.

Read guide β†’
Docs

FB comment cleaner

Bulk-moderate comments under Meta ads: hide, delete and filter by keywords.

Read guide β†’
Docs

Traffic sources and affiliate networks

Catalog of 50+ traffic sources and 440+ networks: templates, parameters and postback URLs.

Read guide β†’
Docs

Reports, logs and metrics

The report builder, saved reports, click logs and every metric explained.

Read guide β†’
Docs

Domains and SSL

Add domains, DNS, free Let's Encrypt certificates, redirects, parking and every switch on the page.

Read guide β†’
Docs

Cloudflare

How to run campaign domains through Cloudflare: DNS, SSL modes and what to turn off.

Read guide β†’
Docs

Administration

Users, roles and permissions, security settings, geo databases, updates and system health.

Read guide β†’
Docs

Telegram bot

Manage the tracker from Telegram: stats, conversions and alerts in chat.

Read guide β†’
Docs

MCP: an AI assistant in the tracker

Connect Claude or any MCP client to Orbitra and manage campaigns with plain-language commands.

Read guide β†’