Migration von Keitaro
Orbitra übernimmt Einstellungen aus Keitaro — Affiliate-Netzwerke, Offers, Domains, Kampagnen mit ihren Click-API-Tokens, Streams mit Filtern, Kampagnen-Postbacks, Landingpages und Quellen. Klick-Statistiken werden nicht übertragen: Das ist ein Neuanfang.
Was übertragen wird
| Keitaro | Orbitra | Was erhalten bleibt |
|---|---|---|
| Affiliate networks | Affiliate-Netzwerke | Postback URL, Offer-Parameter |
| Offers | Offers | URL, Payout, Geo |
| Domains | Domains | Parking, nur HTTPS |
| Groups | Kampagnen-Gruppen | Name |
| Campaigns | Kampagnen | Alias, Click-API-Token, Status, Quelle |
| Streams | Streams | Typ, Position, Gewicht, Schema, Aktion, Filter (einschließlich sub_id_N und Parameter-Filter), „Allow / Deny“-Modi, Verknüpfungen mit Offers und Landingpages |
| Campaign postbacks | S2S Postbacks | URL, Methode, Statuswerte |
| Landing pages | Landingpages | Namen und URLs |
| Sources | Quellen | Parameter |
Nicht übertragen: Klicks und Conversions, User, lokale Landing-Dateien (nur die Datensätze dazu). Filter, die sich nicht übertragen lassen, listet der Import-Report auf.
Keitaros Quellen- und Netzwerk-Templates sind bereits in Orbitra eingebaut — die musst du nicht übertragen (Traffic-Quellen und Affiliate-Netzwerke).
1. Dump auf dem Keitaro-Server
Verbinde dich per SSH als root mit dem Keitaro-Server und führe den Befehl komplett aus. Er nimmt die Datenbank-Zugangsdaten aus /etc/keitaro/env/inventory.env, funktioniert sowohl mit einem MariaDB-Client auf dem Host als auch mit MariaDB im Keitaro-Docker-Container, dumpt nur die Einstellungs-Tabellen (keine Klick-Logs) und verweigert den Lauf, wenn die Tabellen nicht gefunden werden — so dumpst du nie versehentlich die ganze Datenbank.
bash <<'ORBITRA_DUMP'
set -eo pipefail
# Sourced before set -u: the env file is Keitaro's, not ours.
source /etc/keitaro/env/inventory.env
set -u
# Password goes through the environment, never through argv or a file left on disk.
export MYSQL_PWD="$MARIADB_KEITARO_PASSWORD"
DB="$MARIADB_KEITARO_DATABASE"
# MariaDB client on the host, or inside the Keitaro MariaDB container.
if CLI=$(command -v mariadb || command -v mysql) && DUMP=$(command -v mariadb-dump || command -v mysqldump); then
sql() { "$CLI" -u"$MARIADB_KEITARO_USER" -h127.0.0.1 -P3306 --protocol=tcp "$@" </dev/null; }
dump() { "$DUMP" -u"$MARIADB_KEITARO_USER" -h127.0.0.1 -P3306 --protocol=tcp "$@" </dev/null; }
else
CT=$(docker ps --format '{{.Names}}' 2>/dev/null | grep -i -m1 -E 'mariadb|mysql' || true)
if [ -z "$CT" ]; then
echo "ERROR: no MariaDB client on this server and no MariaDB container found" >&2
exit 1
fi
echo "Using MariaDB inside container: $CT"
sql() { docker exec -e MYSQL_PWD "$CT" sh -c 'exec $(command -v mariadb || command -v mysql) "$@"' sh -u"$MARIADB_KEITARO_USER" "$@" </dev/null; }
dump() { docker exec -e MYSQL_PWD "$CT" sh -c 'exec $(command -v mariadb-dump || command -v mysqldump) "$@"' sh -u"$MARIADB_KEITARO_USER" "$@" </dev/null; }
fi
# Settings tables only: campaigns, offers, domains, streams... - no click logs.
TABLES=$(sql -N "$DB" -e "
SELECT table_name FROM information_schema.tables
WHERE table_schema = DATABASE()
AND table_name IN (
'keitaro_affiliate_networks', 'keitaro_groups', 'keitaro_offers',
'keitaro_domains', 'keitaro_campaigns', 'keitaro_campaign_postbacks',
'keitaro_landings', 'keitaro_streams', 'keitaro_stream_filters',
'keitaro_stream_offer_associations', 'keitaro_stream_landing_associations',
'keitaro_traffic_sources', 'keitaro_ref_sources')
ORDER BY table_name" | tr '\n' ' ')
# Without a table list mysqldump would dump the WHOLE database, click logs included.
if [ -z "$(echo $TABLES)" ]; then
echo "ERROR: no Keitaro tables found in database $DB" >&2
exit 1
fi
OUT=/root/keitaro_orbitra_full.sql.gz
echo "Dumping tables: $TABLES"
dump --single-transaction --quick --skip-lock-tables "$DB" $TABLES | gzip -1 > "$OUT"
ls -lah "$OUT"
echo "DONE: $OUT"
ORBITRA_DUMP
Am Ende siehst du DONE: /root/keitaro_orbitra_full.sql.gz. Die Datei ist meist 1–5 MB groß.
2. Datei herunterladen
Auf der Seite ⚙ → Migrations gibst du die IP des Keitaro-Servers ein — das Panel setzt sie in fertige Befehle ein. Führe den Befehl auf deinem Computer aus, nicht auf dem Server:
# macOS / Linux
scp root@IP_KEITARO:/root/keitaro_orbitra_full.sql.gz ~/Downloads/
# Windows (PowerShell)
scp root@IP_KEITARO:/root/keitaro_orbitra_full.sql.gz $env:USERPROFILE\Downloads\
3. Import nach Orbitra
⚙ → Migrations → Import from Keitaro (SQL dump):
- Wähle eine
.sql.gz- oder.sql-Datei. Der Dump wird nicht als SQL ausgeführt — er wird nur geparst. - Hak an, was importiert werden soll. Keep campaign IDs (Orbitra-ID = Keitaro-ID) funktioniert nur auf einer sauberen Installation, in der die Kampagnen-Tabelle leer ist — Archiv mitgezählt.
- Show preview — ein Dry-Run ohne Schreiben: wie viele Objekte jedes Typs importiert werden und welche Filter nicht übernommen werden.
- Import into Orbitra.
Für wiederholte Importe auf einem Test-Server gibt es den Block Cleanup: Er löscht die komplette Konfiguration des Trackers (Domains, Offers, Affiliate-Netzwerke, Kampagnen, Streams, Postbacks, Pixel, Quellen, Landingpages, Gruppen), ohne Statistiken oder User anzufassen. Zur Bestätigung musst du DELETE tippen.
4. Nach dem Import
- Tokens. Öffne ein paar Kampagnen — das Click-API-Token sollte mit Keitaros übereinstimmen. Dann laufen die Integration-Scripts auf deinen Seiten (
click.php, KClient) weiter; du musst nur die Tracker-Adresse darin ändern. - Domains. Zeige die A-Einträge der Domains auf den neuen Server (oder verbinde Cloudflare / Namecheap / Dynadot — die Einträge werden automatisch gesetzt) und warte auf die Zertifikate (Domains und SSL).
- Netzwerk-Postbacks. Die Postback URL ist in Orbitra eine andere:
https://your-domain/<postback_key>/postback?…. Aktualisiere sie in den Dashboards der Netzwerke (Postbacks). - Geo-Datenbank. Ohne sie funktionieren Länderfilter nicht — prüfe ⚙ → Geo databases.
- Routing-Check. Der Kampagnen-Test-Link mit
&_dbg=1zeigt, welcher Stream gewählt wird und warum, ganz ohne einen Klick zu schreiben (Kampagnen und Streams).
Häufige Probleme
| Symptom | Ursache und Lösung |
|---|---|
Der Dump-Befehl sagt no Keitaro tables found | Falsche Datenbank in inventory.env oder eine nicht-standardmäßige Keitaro-Installation. Prüfe MARIADB_KEITARO_DATABASE |
no MariaDB client … and no MariaDB container found | Weder ein MariaDB-Client noch ein laufender MariaDB-Container — starte Keitaro oder installiere den Client |
| Der Import hat nichts gefunden | Der Dump ist leer oder aus der falschen Datenbank — prüfe die Dateigröße und die Zeile Dumping tables: in der Befehlsausgabe |
| Streams wurden nicht übertragen | Die Option „Import streams“ war nicht angehakt, oder im Dump fehlen keitaro_streams und die Verknüpfungs-Tabellen |
| Die Domain antwortet mit 404 | Das DNS zeigt noch nicht auf den neuen Server, oder der Domain ist keine Index-Kampagne zugewiesen |
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 →DocsInstallation und Updates
Systemvoraussetzungen, der Ein-Befehl-Installer, PHP-Updates inklusive Sicherheits-Hinweisen, Panel-Zugriff per IP und die lokale Entwicklungsumgebung.
Guide lesen →DocsMigration 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 →DocsMigration von Binom
Kampagnen, Offers, Streams und mehr direkt über die Binom-v2-Public-API importieren — ohne Dump-Datei, inklusive Mapping-Hinweisen.
Guide lesen →DocsFunktionen 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 →DocsKampagnen 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 →DocsCloaking (Referenz)
Die vollständige Cloaking-Referenz: Detection layers, Sensitivity, Targeting filters, JavaScript-Verifizierung, Verdicts, Gründe und Diagnostik.
Guide lesen →DocsBrowser check
Bots, Moderator-VMs, Emulatoren und Anti-Detect-Browser an Widersprüchen im Browser selbst erkennen — Modi, Anzeichen und der sichere Einstieg.
Guide lesen →DocsLandingpages (Referenz)
Die vollständige Landingpage-Referenz: lokale, Redirect-, Preload- und Action-Landingpages, das {offer}-Makro, SubID-Weitergabe, JS-Adapter und PHP-Landings.
Guide lesen →DocsPWA und Web Push
PWA-Landingpages und eigenes Web Push: Builder, Domain-Bindung, VAPID-Keys, Abonnenten, Messages, der Versand-Cron, Attribution und Fehlerbehebung.
Guide lesen →DocsPWA Funnel
Der PWA-Besuch als konfigurierbarer Funnel: Screens in fester Reihenfolge, Event-Tracking pro Screen und Re-Engagement-Benachrichtigungen.
Guide lesen →DocsConversion-Popups
Echte Conversion-Events als Popup auf der Landing zeigen: Einrichtung pro Kampagne, Trigger und Platzierung.
Guide lesen →DocsSession-Aufzeichnungen und Heatmaps
Echte Besuche wie ein Video abspielen, dazu Klick-Heatmap und Scroll-Map. Speicher-Limits und Datenschutz-Hinweise.
Guide lesen →DocsContent Gallery
Die zentrale Mediathek des Trackers für Icons, Screenshots und Creatives, genutzt in PWAs und Landings: Ordner, Uploads, MediaPicker.
Guide lesen →DocsCreatives-Bibliothek
Creatives mit SubID-Tracking speichern und über Kampagnen hinweg testen.
Guide lesen →DocsExterne PWA und Telegram-Kanäle
PWAs auf externen Domains veröffentlichen und Telegram-Kanäle als Traffic-Quelle mit zuordenbaren Abonnenten fahren.
Guide lesen →DocsPostbacks und Conversions
Eingehende Postbacks, Conversion-Statuswerte und -Typen sowie ausgehende S2S-Postbacks an die Traffic-Quelle.
Guide lesen →DocsKosten
Spend aus Facebook, TikTok und Google Ads importieren oder per API und Cron pflegen — und wie der Revenue Aggregator arbeitet.
Guide lesen →DocsPush- und Pop-Netzwerke
Arbeit mit Push- und Pop-Traffic-Quellen: Feeds, Zonen-Optimierung und der Zone Killer.
Guide lesen →DocsFacebook / Meta
Kosten-Import aus Meta Ads und die Conversions API: serverseitige Events mit Deduplizierung.
Guide lesen →DocsDolphin / 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 →DocsFB-Kommentar-Cleaner
Spam-Kommentare unter Meta-Ads nach Zeitplan verstecken oder löschen: Regelwerke, Presets, Ausnahmen, Dry-run und Auto-Pause.
Guide lesen →DocsTraffic-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 →DocsReports, 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 →DocsDomains und SSL
Domains hinzufügen, DNS und A-Records, kostenlose Let's-Encrypt-Zertifikate, Cloudflare-Proxy und alle Schalter der Domain-Einstellungen.
Guide lesen →DocsCloudflare
Kampagnen-Domains über Cloudflare fahren: API-Token, Accounts, automatische A-Records, SSL-Modi und der orange Cloud-Proxy.
Guide lesen →DocsAdministration
Users, Rollen und Rechte, Settings, Geo-Datenbanken, Updates und Systemstatus — die Verwaltung des Trackers über das ⚙-Menü.
Guide lesen →DocsTelegram-Bot
Den Tracker aus Telegram steuern: Statistiken, Kampagnen und Conversions per Befehl, dazu Benachrichtigungen und tägliches Digest.
Guide lesen →DocsMCP: 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 →