Betaflight-Backup: diff all sichern und zurückspielen

Bevor du Rates änderst, einen Preset einspielst oder neue Firmware flashst, sicherst du deine Einstellungen. Dafür reicht ein Befehl in der Kommandozeile der Betaflight-App: diff all. Hier steht, wie du die Ausgabe als Datei speicherst und zurückspielst, wann dump passt und warum du nach einem Firmware-Update nicht einfach alles einfügst. Geprüft gegen den Quellcode von Betaflight 2026.6.2 (Firmware und App) und die Betaflight-Doku, Stand 12. November 2026.

Sichern in vier Schritten

Der Setup Guide der Betaflight-Doku sagt es knapp: „Bevor du etwas änderst, sichere deine aktuelle Konfiguration.“1 In der Betaflight-App 2026.6 geht das so:

  1. Verbinden: Drohne per USB-Datenkabel an den Computer, in der App auf „Verbinden“, Akku ab. Die App rät selbst, vor Befehlen in der Kommandozeile keinen Akku anzuschließen, weil manche Befehle die Motoren anlaufen lassen können.
  2. Fenster leeren: Tab „Kommandozeile“ öffnen und unten auf „CLI-Ausgaben löschen“ klicken. „In Datei speichern“ nimmt alles, was im Fenster steht (useCli.js); so landet in der Datei nur das Backup.
  3. Befehl senden: diff all eintippen und Enter drücken. Fertig ist die Ausgabe, wenn am Ende save steht.
  4. Speichern: „In Datei speichern“ klicken. Die App schlägt eine .txt-Datei vor, deren Name den Namen der Drohne (Craft name), Datum und Uhrzeit enthält. Alternativ „In die Zwischenablage kopieren“ und in eine Textdatei einfügen.
# Ziel-Drohne: <Name deiner Drohne>
diff all

Alles hinter # ist ein Kommentar, Betaflight ignoriert es (cli.c). Beim Sichern änderst du nichts. Klickst du danach auf „Trennen“ oder wechselst den Tab, schickt die App exit und der Flugcontroller (FC) startet neu, verloren geht dabei nichts. Leg die Datei zusätzlich an einen zweiten Ort, etwa auf einen USB-Stick.

Was in der Datei steht

diff all gibt nur aus, was vom Standard abweicht, aber für alle Profile. Die Ausgabe ist gleich ein Skript zum Zurückspielen. Der Aufbau laut Quellcode (cli.c, Funktion printConfig):

Zeile in der DateiWas sie tut
# version, darunter # Betaflight / … MSP API: …Kommentar mit Firmware-Version, Ziel (Target), Build-Datum und MSP-Version. Dieselbe Zeile zeigt der Befehl version.
batch startStartet eine Batch: Betaflight merkt sich jeden Fehler bis zum save am Ende.
defaults nosaveSetzt alles auf den Standard zurück, ohne zu speichern und ohne Neustart. Danach kommen nur deine Abweichungen dazu.
board_name …, manufacturer_id …, mcu_id …Board und Hersteller (nur wenn gesetzt) und die Kennung des Prozessors. mcu_id zeigt nur an, es ändert nichts.
# name: …Name der Drohne (Craft name) als Kommentar.
feature …, serial …, aux …, set … = …Alles außerhalb der Profile, etwa Ports, Modi und OSD, jeweils nur, was vom Standard abweicht.
profile … mit set … = …Jedes PID-Profil mit seinen Abweichungen, danach wieder dein aktives Profil. Die CLI zählt ab 0: profile 0 ist in der App Profil 1.
rateprofile …, battery_profile …Jedes Ratenprofil und jedes Akku-Profil, danach wieder deine aktive Auswahl.
saveSpeichert und startet den FC neu.

diff oder dump? Wann was

Alle Befehle stehen so in der Hilfe der CLI (cli.c): diff listet „configuration changes from default“, dump die ganze Konfiguration.

BefehlWas drin istWofür
diff allAbweichungen vom Standard, alle PID-, Raten- und Akku-ProfileDas Backup. Setzt beim Zurückspielen erst alles zurück und endet mit save.
diffAbweichungen, nur die aktiven ProfileSchneller Blick, was du geändert hast. Setzt nichts zurück, endet ohne save.
dump allJeder Wert, auch Standardwerte, alle ProfileZwei Stände Zeile für Zeile vergleichen. Endet mit save, setzt aber nichts zurück.
dumpJeder Wert, nur die aktiven ProfileWie dump all, kürzer. Endet ohne save.
diff ratesNur das aktive RatenprofilDeine Rates nachschauen.

Zum Sichern nimmst du diff all: kurz, mit allen Profilen und schon als Skript gebaut. Zwei Zusätze gibt es für diff und dump: defaults (etwa diff all defaults) schreibt über jede geänderte Zeile den Standardwert als Kommentar, bare lässt batch, defaults nosave, save und mcu_id weg.

Zurückspielen auf dieselbe Firmware-Version

  1. Version prüfen: In der Kommandozeile version eingeben. Die Versionsnummer darin muss dieselbe sein wie in der Versionszeile oben in deiner Datei. Ist sie anders, lies erst den Abschnitt zum Firmware-Update.
  2. Datei laden: „Aus Datei laden“ klicken und die .txt-Datei wählen. Die App zeigt den Inhalt erst in einer Vorschau: „Du kannst Befehle vor der Ausführung überprüfen und bearbeiten.“ Mit „Ausführen“ schickt sie ihn Zeile für Zeile an den FC. Oder du kopierst den Inhalt in das Eingabefeld und drückst Enter.
  3. Laufen lassen: defaults nosave setzt zurück, deine Zeilen kommen dazu, save speichert und startet neu.
  4. Prüfen: Neu verbinden und die Tabs durchsehen, vor allem Empfänger, Modi und Motoren. Armt die Drohne danach nicht, zeigt status den Grund; die Liste aller Gründe steht in Drohne armt nicht: alle Arming-Flags.
# Ziel-Drohne: <Name deiner Drohne>
# 1. Version anzeigen, mit der Versionszeile oben in deiner Datei vergleichen
version
# 2. Danach den ganzen Inhalt deiner Datei einfügen und Enter drücken.
#    Er beginnt mit batch start und endet mit save.

Wenn eine Zeile nicht passt

Jeden Fehler zeigt die CLI als Zeile mit ###ERROR IN …###: INVALID NAME für eine Einstellung, die es nicht gibt, INVALID VALUE mit dem erlaubten Bereich für einen Wert außerhalb davon, UNKNOWN COMMAND, TRY 'HELP' für einen unbekannten Befehl (cli.c). Weil diff all als Batch läuft, speichert das save am Ende dann nicht: Betaflight meldet ERRORS WERE DETECTED - PLEASE REVIEW BEFORE CONTINUING und PLEASE FIX ERRORS THEN 'SAVE' (cli.c).

Der FC hat die Datei dann halb übernommen, aber nichts gespeichert. Gib exit ein: Er startet neu und hat wieder den alten Stand („leaving CLI mode, unsaved changes lost“). Dann die Zeile mit dem Fehler in der Datei korrigieren oder löschen und die Datei neu laden.

Datei von einem anderen Flugcontroller

Hier scheitert oft schon die Zeile board_name: Ist auf dem neuen FC ein anderer Boardname gespeichert, meldet Betaflight BOARD_NAME CANNOT BE CHANGED, und das save am Ende greift nicht (cli.c). Richte einen neuen FC deshalb so ein wie nach einem Update: von Hand, mit der alten Datei als Spickzettel, und übernimm nur einzelne Teile.

Wie gut passen deine Rates zu deinem Stick? Der Gratis-Check misst es an deinem Blackbox-Log. Ohne Konto, die Datei bleibt bei dir.

Log gratis prüfen

Noch kein Log? Beispiel-Ergebnis ansehen · Logging einschalten, mit Bildern

Für deinen nächsten Flugtag
  • Betaflight-App, Tab Flugschreiber: Log-Gerät Flash oder SD-Karte, Log-Geschwindigkeit 1 kHz
  • RC Commands, Setpoint und Gyro an, dann „Speichern und Neustarten“
  • 3 bis 5 Akkus ganz normal Acro fliegen
  • Danach den Log von der Drohne holen und in den Gratis-Check ziehen

Nach einem Firmware-Update: nicht blind alles einfügen

Die CLI-Seite der Doku ist eindeutig: „Füge nie einen diff oder dump aus einer Firmware-Version in eine andere ein. Parameternamen und gültige Bereiche ändern sich zwischen den Versionen, und die Konfiguration wird unbemerkt beschädigt.“2 Die Seite zum Firmware Flasher formuliert es weicher: „Grundsätzlich empfehlen wir, alles von Hand neu einzurichten. Wird von derselben Punktversion geflasht, ist es meist in Ordnung, einen gespeicherten Preset zu importieren oder einen diff einzufügen. Teile eines diff lassen sich auch gezielt in die CLI einfügen, etwa die VTX-Tabelle oder die Modi und aux-Einstellungen.“3

Zwei Beispiele, warum. In Betaflight 2026.6 ist die Einstellung pos_hold_without_mag weggefallen, die es in 2025.12 noch gab; laut den Release Notes 2026.6 wird ein gespeicherter diff, der sie enthält, beim Einspielen abgelehnt, die CLI meldet INVALID NAME. Gefährlich wird ein diff aus Betaflight vor 4.3 bei den Rates. Die Doku zu 4.3 warnt: „Fügt jemand seine Betaflight-Rates-Zahlen etwa aus einem ‚diff all‘ ein, fehlt die Angabe rates_type. Dann sind Actual Rates aktiv, aber mit den CLI-Zahlen der Betaflight-Rates. Die Drohne ist nicht flugfähig!“4

So gehst du bei einem Update vor:

  1. Vorher sichern wie oben. Ist der FC beim Flashen normal per USB verbunden, macht die App 2026.6 ab Werk selbst ein Backup per diff all und fragt nach dem Speicherort; brichst du das ab, flasht sie nicht (useFirmwareFlashing.js). Wie das Flashen selbst geht, steht in Betaflight-Firmware flashen und updaten.
  2. Gleiche Version: Datei zurückspielen wie oben.
  3. Neue Version: In den Tabs von Hand einrichten, die alte Datei als Spickzettel daneben. Teile, die die Doku nennt, etwa die Modi (aux) oder die VTX-Tabelle (vtxtable), fügst du gezielt in die Kommandozeile ein. Mit batch start davor speichert das save nur, wenn keine Zeile einen Fehler hatte.
  4. Rates trägst du in der App neu ein, wie in Betaflight-Rates einstellen beschrieben. Kopierst du sie doch aus der Datei, nimm die Zeile rates_type mit, wenn sie dort steht.
  5. Vor dem ersten Flug: „Prüfe nach dem Flashen immer, ob jede Einstellung so ist, wie sie sein soll, bevor du testfliegst.“5
# Ziel-Drohne: <Name deiner Drohne>
batch start
# hier die Zeilen aus deiner alten Datei einfügen, die mit aux beginnen
save

Was die Betaflight-App 2026.6 selbst sichert

  • Tab „Presets“: „Backup speichern“ holt ein diff all und speichert es als .txt, „Backup laden“ spielt so eine Datei wie einen Preset ein. Bei Fehlern listet die App die betroffenen Befehle (Meldung auf Englisch: „Configuration has been applied with CLI errors“) und fragt: „Abbrechen“ (nichts wird gespeichert) oder „Trotzdem speichern“. Beides braucht Firmware 4.5.4 oder neuer (PresetsTab.vue). Vor dem Anwenden von Presets warnt die App selbst, ohne Backup gebe es keine Möglichkeit, zur vorherigen Konfiguration zurückzukehren.
  • Firmware Flasher: Das Backup vor dem Flashen ist ab Werk an; gab es eins, bietet die App nach erfolgreichem Flashen „Restore Backup“ an. Die Einstellung „Create a backup before flashing new target“ steht in den erweiterten Optionen, die die App nur im Expertenmodus zeigt. Beide Texte erscheinen auch in der deutschen App englisch, weil die Übersetzung fehlt.
  • Tab „Backups“: Sicherungen in einem Betaflight-Konto in der Cloud, mit „Restore“ zum Zurückspielen. Den Tab gibt es nur, wenn du in der App angemeldet bist (Release Notes 2026.6).

Der Weg über die Kommandozeile braucht kein Konto, die Datei ist als Text lesbar, und er geht auch mit Firmware vor 4.5.4.

Vor dem Ändern der Rates: erst sichern

Rates änderst du in der App oder per CLI-Block. Der CLI-Block, den fpvrates mit dem Tuning-Pass ausgibt, schreibt in Ratenprofil 3 der App und lässt deine anderen Ratenprofile, wie sie sind. Gesichert wird trotzdem vorher: diff all, Datei speichern, dann einfügen. So kommst du jederzeit auf deinen alten Stand zurück. Ob deine jetzigen Rates zu deinem Stick passen, zeigt der Gratis-Check an deinem Blackbox-Log; wie du das Log aufzeichnest und ausliest, steht in Blackbox-Log einrichten und auslesen.

Quellen

Stand 12. November 2026, geprüft gegen Betaflight 2026.6.2 (Firmware und App vom 16. September 2026, an diesem Tag die neuesten Versionen):

Originalzitate (Englisch) und Quellen

Die Zitate stammen aus der englischen Betaflight-Doku. Im Text stehen sie von fpvrates übersetzt, hier im Wortlaut mit Quelle.

  1. “Before making any changes, back up your current configuration.” Betaflight-Doku: Setup Guide ↩
  2. “Never paste a diff or dump from one firmware version into a different version — variable names and valid ranges change between releases and will silently corrupt the configuration.” Betaflight-Doku: Command Line Interface (CLI) ↩
  3. “Generally, we recommend full manual re-configuration. When the flash is from the same point version, usually it's OK to import a saved Preset, or paste a Diff. Parts of a diff can also be selectively pasted into the CLI, eg the VTX Table, or the modes and aux settings.” Betaflight-Doku: Firmware Flasher Tab ↩
  4. “If a user pastes in their Betaflight rates numbers from say a 'diff all', the rates_type information will not be included. The result will be that Actual Rates will be active, but with Betaflight CLI numbers. The quad will be un-flyable!” Betaflight-Doku: Betaflight 4.3 Tuning Notes ↩
  5. “After flashing, always check that every setting is 'as it should be', before test flying.” Betaflight-Doku: Firmware Flasher Tab ↩

Stand: 12. November 2026 · geprüft mit Betaflight 2026.6.2