Docs

Installation und Updates

Orbitra ist fĂŒr einen schnellen Start ohne komplexes Environment-Setup optimiert. Es baut auf einem schlanken PHP + SQLite + Nginx-Stack auf — ohne separaten DB-Server (kein ClickHouse, Redis oder MySQL).

Systemvoraussetzungen

Orbitra speichert alles in einer einzigen SQLite-Datei und braucht deshalb deutlich weniger RAM als ClickHouse-basierte Tracker — ein gĂŒnstigster VPS-Tarif reicht.

Basis (erforderlich):

GrĂ¶ĂŸenordnung nach Traffic-Volumen (Richtwert):

Klicks pro TagRAMCPUFestplatte
bis ~100.0001–2 GB1–2 vCPU20 GB SSD
~100.000 – 500.0002–4 GB2 vCPU40 GB SSD
~500.000 – 1.000.0004–8 GB4 vCPU80 GB SSD

✅ In der Praxis verifiziert: Orbitra lĂ€uft stabil auf einem 2 vCPU / 2 GB RAM / 20 GB SSD-VPS (Ubuntu 24.04) mit wenig Traffic — ein bequemer und gĂŒnstiger Startpunkt. Die oberen Tabellenzeilen sind Reserve fĂŒr höheres Traffic-Volumen, keine harte Anforderung.

💡 Warum weniger als Keitaro? Keitaro speichert Klicks in ClickHouse + Redis + MySQL, wachsen seine RAM-Anforderungen doch bis 64 GB bei Millionen Klicks pro Tag. In Orbitra lebt alles in einer einzigen SQLite-Datei — der Flaschenhals ist nicht der RAM, sondern Disk-I/O und SQLites single-threaded Writes. FĂŒr kleine und mittlere Volumen (im WAL-Modus) reicht das; fĂŒr dauerhaft Millionen Klicks pro Tag mit schwergewichtiger Analytik ist ein Tracker mit Columnar-DB (wie Keitaro) architektonisch die bessere Wahl.

💡 Bei der Installation auf einem 1-GB-RAM-Server: fĂŒge 1–2 GB Swap hinzu — das Bauen des Frontends (Vite) ist der speicherhungrigste Schritt. Der Tracker selbst lĂ€uft problemlos mit 1 GB.

Schnelle automatische Installation (Production)

Der schnellste und richtige Weg, das Projekt auf einem Server zu starten, ist der eingebaute Installer.

  1. Stelle sicher, dass du einen „sauberen“ Linux-Server hast (Ubuntu 22.04+ oder Debian 12+).
  2. FĂŒhre den Befehl als root/sudo aus:
   wget -O orbitra-install.sh https://raw.githubusercontent.com/fenjo26/Orbitra.link/main/install.sh && bash orbitra-install.sh

Der Download ist mit Absicht ein eigener Schritt: Bei wget -qO- 
 | bash pumpt ein fehlgeschlagener Download stumm Leere in bash, und die Installation „ist fertig“, ohne eine einzige Ausgabezeile. So stoppt sie an &&, und wget meldet den Grund.

  1. Das Script installiert Nginx, ein aktuelles PHP (8.5, mit Fallback auf 8.4 aus dem Ondƙej-SurĂœ-Repository; ist auch das nicht verfĂŒgbar — das der Distribution), SQLite, lĂ€dt den Frontend-Code herunter und richtet HTTPS-Zertifikate ein.

Erste Anmeldung: Es gibt keinen „Default“-Account. Öffne nach der Installation http://<your-domain>/admin.php — beim ersten Start startet Orbitra den Einrichtungs-Wizard, in dem du deinen eigenen Administrator anlegst (Login ≄ 3 Zeichen, Passwort ≄ 8 Zeichen, Zeitzone und Sprache).

Panel-Zugriff per IP

Das Panel ist immer unter der Server-Adresse erreichbar — http://<ip>/admin.php — egal wie viele Domains du bindest und welche du spĂ€ter löschst. DafĂŒr sorgt ein Catch-all-Block, den Orbitra an den Anfang der Nginx-Konfiguration setzt; Zertifikate werden via certbot certonly --webroot ausgestellt, sodass Certbot die Konfiguration nicht umschreibt.

https://<ip>/admin.php funktioniert ebenfalls, aber mit Browser-Warnung: Let's Encrypt stellt keine Zertifikate fĂŒr nackte IPs aus, daher wird ein selbstsigniertes verwendet.

Wenn das Panel trotzdem nicht mehr antwortet — etwa weil die Nginx-Konfiguration von Hand bearbeitet wurde — baue sie aus der Datenbank neu auf:

sudo php /var/www/orbitra/cli/nginx_sync.php

Der Befehl repariert auch Certbot-Renewal-Konfigurationen aus der alten Ausstellungsmethode und erzeugt ein selbstsigniertes Zertifikat. Nach einem Update von einer Version unter 0.9.6.4 einmal ausfĂŒhren.

Was das Installations-Script einrichtet

Nicht automatisch installiert: Retention-basiertes AufrÀumen (cli/cleanup_cron.php, siehe Administration), der Postback-Monitor und Quellen-URL-Checks.

Den Installer auf einem laufenden Server erneut auszufĂŒhren ist gefahrlos: Er aktualisiert PHP, Konfigurationen und Crons, ohne Daten anzufassen.

Die Panel-Sicherheitseinstellungen nach der Installation — eigener Panel-Pfad, Zugriff per IP, Zwei-Faktor-Login — sind in Administration beschrieben.

PHP aktualisieren

Sicherheitshinweis: CVE-2026-109618 / CVE-2026-109619 (Oktober 2026)

Zwei kritische, nicht authentifizierbare RCE-Schwachstellen in PHP selbst („php2shell“, CVSS v4.0 9.2, öffentlicher Exploit) wurden upstream am 21.10.2026 gepatcht. Behobene Versionen: 8.5.12, 8.4.27, 8.3.36, 8.2.35. Ein Tracker ist eine PHP-App im offenen Internet, also muss jeder web-seitige Interpreter gepatcht sein. Das Panel zeigt ein rotes Banner auf dem Dashboard, bis das laufende PHP eine dieser Versionen (oder neuer) meldet.

Routine-Upgrade

Ubuntu 22.04 / Debian 12 / Ubuntu 24.04 liefern PHP 8.1 / 8.2 / 8.3 mit — diese Versionen erhalten keine Sicherheitsupdates mehr (8.1 und 8.2 sind EOL; 8.3 bekommt nur Security-Fixes bis Ende 2027). Orbitra v1.5.10 lĂ€uft auf allen, aber eine frische Installation oder ein Server-Upgrade sollte bei PHP 8.4+ beginnen.

Der einfachste Weg ist, den Installer erneut auszufĂŒhren (er ist idempotent und unterstĂŒtzt das Upgrade ĂŒber eine bestehende Installation):

sudo bash /var/www/orbitra/install.sh

Der Installer fĂŒgt das Repository der aktuellen PHP-Builds hinzu (ondrej/php auf Ubuntu, packages.sury.org auf Debian), installiert PHP 8.5 (mit Fallback auf 8.4) parallel zum alten, stellt die php-CLI-Alternative um (von Crons und Composer genutzt), schreibt die Nginx-Konfiguration auf den neuen FPM-Socket um, setzt die Pool-Einstellungen und startet die Dienste neu. Die alte PHP-Version bleibt installiert, serviert aber keinen Traffic mehr; nach einer PrĂŒfung kannst du sie entfernen, wenn du magst.

Manuell (Ubuntu):

sudo add-apt-repository -y ppa:ondrej/php && sudo apt-get update
sudo apt-get install -y php8.5-fpm php8.5-cli php8.5-sqlite3 php8.5-curl php8.5-mbstring php8.5-xml php8.5-zip php8.5-intl php8.5-bcmath
sudo update-alternatives --set php /usr/bin/php8.5
sudo bash /var/www/orbitra/install.sh   # switches nginx/FPM/crons to the new version

Manuell (Debian):

. /etc/os-release
curl -fsSL https://packages.sury.org/php/apt.gpg | sudo gpg --dearmor --yes -o /usr/share/keyrings/deb.sury.org-php.gpg
echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ ${VERSION_CODENAME} main" | sudo tee /etc/apt/sources.list.d/php-sury.list
sudo apt-get update
sudo apt-get install -y php8.5-fpm php8.5-cli php8.5-sqlite3 php8.5-curl php8.5-mbstring php8.5-xml php8.5-zip php8.5-intl php8.5-bcmath
sudo update-alternatives --set php /usr/bin/php8.5
sudo bash /var/www/orbitra/install.sh

PrĂŒfe nach dem Update: php -v zeigt 8.4/8.5, das Panel öffnet sich, unter Logs → System log stehen keine postback.php database error-EintrĂ€ge, und der Worker-Ping in den Einstellungen der Postback-Warteschlange ist frisch. Beim Update ĂŒber den Button warnt das Panel von selbst, wenn der Server bei PHP < 8.4 bleibt.

Einmaliger Server-Schritt nach dem Update (1.6.0+)

Der „Update“-Button im Panel lĂ€uft als Web-User und kann sudoers nicht Ă€ndern. Server, die vor 1.6.0 installiert wurden, brauchen nach dem Update einen einzelnen Lauf von cli/server_setup.sh als root — das Panel zeigt ein Banner mit dem Befehl:

curl -fsSL https://raw.githubusercontent.com/fenjo26/Orbitra.link/v1.6.0/cli/server_setup.sh | sudo ORBITRA_REF=v1.6.0 bash

Das Script wird vom Release-Tag geladen, nicht aus /var/www/orbitra (das Verzeichnis gehört dem Web-User, und root darf keine Dateien ausfĂŒhren, die der Web-User umschreiben kann). Es ersetzt die alten sudo-Regeln (certbot mit beliebigen Argumenten und cp nach sites-available — jede hĂ€tte dem Web-User Root verschaffen können) durch Helfer mit Argument-Validierung, installiert den Klick-Warteschlangen-Cron und schreibt die Version nach /etc/orbitra/server-setup-version. Ein erneuter Lauf ist gefahrlos. install.sh ruft dasselbe Script auf, bekommen also auch neue Installationen.

Nach dem Update auf 1.8.4: Nginx-Hardening (Oktober-2026-Hinweise)

Auf dem Server ist nichts auszufĂŒhren: Das Update selbst generiert den Nginx-vhost ohne die alias-Direktive neu und lĂ€dt nginx neu (ĂŒber denselben verifizierten Weg, den auch das Speichern einer Domain nutzt). Übrig bleibt die Betriebssystem-HĂ€lfte der Oktober-2026-Hinweise — das nginx-Paket selbst (bis CVSS 9.2 eingestuft), der Kernel und der CA-Trust-Store — die nur der Betreiber aktualisieren kann:

apt update && NEEDRESTART_MODE=a apt upgrade -y   # Debian/Ubuntu; dnf upgrade on the RHEL family
systemctl reload nginx
reboot                                             # loads the fixed kernel
nginx -v                                           # fixed: 1.31.7+ mainline / 1.30.6+ stable

Distro-Builds können den Fix backporten, ohne die Version anzuheben — prĂŒfe das mit apt changelog nginx. Das Dashboard zeigt ein wegklickbares Banner, bis das laufende nginx eine behobene Version meldet (sofern eine Shell zum Nachlesen verfĂŒgbar ist). Die PostgreSQL-/Redis-/Node.js-Punkte desselben Digests betreffen den Tracker nicht: Er lĂ€uft auf PHP + SQLite und bringt kein Node.js auf den Server.

Nach dem Update auf 1.8.3: Session-Aufzeichnungen fĂŒr ganze Websites

Auf dem Server ist nichts auszufĂŒhren. Das Update bringt die Session-Aufzeichnungen auf Kampagnenebene mit One click per visit (Besuch-ZusammenfĂŒhrung) und dem Consent-Modus, alles standardmĂ€ĂŸig aus — Klick-Statistik und Aufzeichnungen Ă€ndern sich nur, wo du sie selbst einschaltest. Kein Cron nachzuinstallieren: Das AufrĂ€umen fĂ€hrt weiterhin mit den eingehenden Aufzeichnungen mit.

Nach dem Update auf 1.8.2: Browser check

Auf dem Server ist nichts auszufĂŒhren. Das Update bringt den Browser check mit, lĂ€sst ihn auf einer bestehenden Installation aber aus, damit sich das Routing nicht von selbst Ă€ndert. Admins sehen ein einmaliges Banner auf dem Dashboard: Turn on soft mode schaltet ein, Learn more öffnet Settings → Bots, Not now blendet das Banner aus (der Modus lĂ€sst sich jederzeit in Settings → Bots Ă€ndern). Eine frische Installation startet im Soft-Modus.

Update-IntegritÀt

Lokale Entwicklung (React & PHP-Server)

Wenn du den Frontend-Quellcode (React) und die visuelle Seite des Trackers Àndern willst, brauchst du ein lokales PHP + Vite Setup.

Teil 1: Backend-API starten

Öffne ein erstes Terminal und starte den eingebauten PHP-Server mit dem Router:

cd Orbitra
php -S localhost:8080 router.php

Dieser Server verarbeitet API-Anfragen und Redirects.

Teil 2: Frontend starten (Vite)

Öffne ein zweites Terminal, installiere die npm-Pakete und starte den Dev-Server:

cd Orbitra/frontend
npm install
npm run dev

Öffne dann http://localhost:5173 im Browser. Alle API-Anfragen aus dem Frontend werden automatisch (ĂŒber den Proxy in vite.config.js) an http://localhost:8080/api.php weitergeleitet — so vermeidest du CORS- und Session-Probleme im Entwicklungsmodus.

Das Panel bauen

Nur nötig, wenn du den Panel-Code Ànderst:

cd Orbitra/frontend
npm run build

Das Build landet in frontend/dist/, das im Repository committed ist — der Server nimmt das fertige Panel per git pull oder ĂŒber ein Update aus dem Panel und baut selbst nichts.

Telegram-Bot

Anbindung und Betriebsmodi — Telegram-Bot.

← ZurĂŒck
Schnellstart
Weiter →
Migration von Keitaro
Quelle auf GitHub ansehen: github.com/fenjo26/Orbitra.link/wiki
Alle Guides
Docs

Schnellstart

Von einem nackten Server zur ersten Conversion in neun Schritten: Installation, erster Login, Domain, Netzwerk und Offer, Traffic-Quelle, Kampagne, PrĂŒfung, Kosten.

Guide lesen →
Docs

Installation und Updates

Systemvoraussetzungen, der Ein-Befehl-Installer, PHP-Updates inklusive Sicherheits-Hinweisen, Panel-Zugriff per IP und die lokale Entwicklungsumgebung.

Guide lesen →
Docs

Migration von Keitaro

Einstellungen per SQL-Dump von Keitaro zu Orbitra ĂŒbertragen: was mitkommt, das Dump-Script, der Import und was du danach prĂŒfen solltest.

Guide lesen →
Docs

Migration von Binom

Kampagnen, Offers, Streams und mehr direkt ĂŒber die Binom-v2-Public-API importieren — ohne Dump-Datei, inklusive Mapping-Hinweisen.

Guide lesen →
Docs

Funktionen im Überblick

Alle Orbitra-Funktionen auf einen Blick: Traffic und Schemas, Postbacks und Kosten, Analytics, Infrastruktur und Verwaltung — mit Links auf die Detailseiten.

Guide lesen →
Docs

Kampagnen und Streams

Der Kampagnen-Editor im Detail: Reiter, Kostenmodelle, Stream-Typen, alle Filter, Schemas, Rotation mit Auto-Optimierung, Test-Link und Duplikat-Schutz.

Guide lesen →
Docs

Cloaking (Referenz)

Die vollstĂ€ndige Cloaking-Referenz: Detection layers, Sensitivity, Targeting filters, JavaScript-Verifizierung, Verdicts, GrĂŒnde und Diagnostik.

Guide lesen →
Docs

Browser check

Bots, Moderator-VMs, Emulatoren und Anti-Detect-Browser an WidersprĂŒchen im Browser selbst erkennen — Modi, Anzeichen und der sichere Einstieg.

Guide lesen →
Docs

Landingpages (Referenz)

Die vollstÀndige Landingpage-Referenz: lokale, Redirect-, Preload- und Action-Landingpages, das {offer}-Makro, SubID-Weitergabe, JS-Adapter und PHP-Landings.

Guide lesen →
Docs

PWA und Web Push

PWA-Landingpages und eigenes Web Push: Builder, Domain-Bindung, VAPID-Keys, Abonnenten, Messages, der Versand-Cron, Attribution und Fehlerbehebung.

Guide lesen →
Docs

PWA Funnel

Der PWA-Besuch als konfigurierbarer Funnel: Screens in fester Reihenfolge, Event-Tracking pro Screen und Re-Engagement-Benachrichtigungen.

Guide lesen →
Docs

Conversion-Popups

Echte Conversion-Events als Popup auf der Landing zeigen: Einrichtung pro Kampagne, Trigger und Platzierung.

Guide lesen →
Docs

Session-Aufzeichnungen und Heatmaps

Echte Besuche wie ein Video abspielen, dazu Klick-Heatmap und Scroll-Map. Speicher-Limits und Datenschutz-Hinweise.

Guide lesen →
Docs

Content Gallery

Die zentrale Mediathek des Trackers fĂŒr Icons, Screenshots und Creatives, genutzt in PWAs und Landings: Ordner, Uploads, MediaPicker.

Guide lesen →
Docs

Creatives-Bibliothek

Creatives mit SubID-Tracking speichern und ĂŒber Kampagnen hinweg testen.

Guide lesen →
Docs

Externe PWA und Telegram-KanÀle

PWAs auf externen Domains veröffentlichen und Telegram-KanÀle als Traffic-Quelle mit zuordenbaren Abonnenten fahren.

Guide lesen →
Docs

Postbacks und Conversions

Eingehende Postbacks, Conversion-Statuswerte und -Typen sowie ausgehende S2S-Postbacks an die Traffic-Quelle.

Guide lesen →
Docs

Kosten

Spend aus Facebook, TikTok und Google Ads importieren oder per API und Cron pflegen — und wie der Revenue Aggregator arbeitet.

Guide lesen →
Docs

Push- und Pop-Netzwerke

Arbeit mit Push- und Pop-Traffic-Quellen: Feeds, Zonen-Optimierung und der Zone Killer.

Guide lesen →
Docs

Facebook / Meta

Kosten-Import aus Meta Ads und die Conversions API: serverseitige Events mit Deduplizierung.

Guide lesen →
Docs

Dolphin / Fbtool

Facebook-Kosten ĂŒber den Keitaro-kompatiblen Admin-API-Endpunkt empfangen: API-Key, Dolphin- und Fbtool-Setup und wie der Spend auf die Klicks verteilt wird.

Guide lesen →
Docs

FB-Kommentar-Cleaner

Spam-Kommentare unter Meta-Ads nach Zeitplan verstecken oder löschen: Regelwerke, Presets, Ausnahmen, Dry-run und Auto-Pause.

Guide lesen →
Docs

Traffic-Quellen und Affiliate-Netzwerke

Die beiden Verzeichnisse am Funnel-Rand: Templates fĂŒr rund 200 Quellen und 440 Netzwerke, Parameter, Makros und Postback-URLs.

Guide lesen →
Docs

Reports, Logs und Metriken

Der Report-Builder, Traffic-Log, Klick-Karte und jede Metrik erklĂ€rt — von Clicks und Visits ĂŒber ROI bis zur Scroll-Tiefe.

Guide lesen →
Docs

Domains und SSL

Domains hinzufĂŒgen, DNS und A-Records, kostenlose Let's-Encrypt-Zertifikate, Cloudflare-Proxy und alle Schalter der Domain-Einstellungen.

Guide lesen →
Docs

Cloudflare

Kampagnen-Domains ĂŒber Cloudflare fahren: API-Token, Accounts, automatische A-Records, SSL-Modi und der orange Cloud-Proxy.

Guide lesen →
Docs

Administration

Users, Rollen und Rechte, Settings, Geo-Datenbanken, Updates und Systemstatus — die Verwaltung des Trackers ĂŒber das ⚙-MenĂŒ.

Guide lesen →
Docs

Telegram-Bot

Den Tracker aus Telegram steuern: Statistiken, Kampagnen und Conversions per Befehl, dazu Benachrichtigungen und tÀgliches Digest.

Guide lesen →
Docs

MCP: ein KI-Assistent im Tracker

Claude oder einen anderen MCP-Client an Orbitra anbinden und Kampagnen, Offers und Domains in natĂŒrlicher Sprache verwalten.

Guide lesen →