Docs

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

KeitaroOrbitraWas erhalten bleibt
Affiliate networksAffiliate-NetzwerkePostback URL, Offer-Parameter
OffersOffersURL, Payout, Geo
DomainsDomainsParking, nur HTTPS
GroupsKampagnen-GruppenName
CampaignsKampagnenAlias, Click-API-Token, Status, Quelle
StreamsStreamsTyp, Position, Gewicht, Schema, Aktion, Filter (einschließlich sub_id_N und Parameter-Filter), „Allow / Deny“-Modi, Verknüpfungen mit Offers und Landingpages
Campaign postbacksS2S PostbacksURL, Methode, Statuswerte
Landing pagesLandingpagesNamen und URLs
SourcesQuellenParameter

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):

  1. Wähle eine .sql.gz- oder .sql-Datei. Der Dump wird nicht als SQL ausgeführt — er wird nur geparst.
  2. 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.
  3. Show preview — ein Dry-Run ohne Schreiben: wie viele Objekte jedes Typs importiert werden und welche Filter nicht übernommen werden.
  4. 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

Häufige Probleme

SymptomUrsache und Lösung
Der Dump-Befehl sagt no Keitaro tables foundFalsche Datenbank in inventory.env oder eine nicht-standardmäßige Keitaro-Installation. Prüfe MARIADB_KEITARO_DATABASE
no MariaDB client … and no MariaDB container foundWeder ein MariaDB-Client noch ein laufender MariaDB-Container — starte Keitaro oder installiere den Client
Der Import hat nichts gefundenDer Dump ist leer oder aus der falschen Datenbank — prüfe die Dateigröße und die Zeile Dumping tables: in der Befehlsausgabe
Streams wurden nicht übertragenDie Option „Import streams“ war nicht angehakt, oder im Dump fehlen keitaro_streams und die Verknüpfungs-Tabellen
Die Domain antwortet mit 404Das DNS zeigt noch nicht auf den neuen Server, oder der Domain ist keine Index-Kampagne zugewiesen
← Zurück
Installation und Updates
Weiter →
Migration von Binom
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 →