Dieser Artikel erklärt, wie du die BitBoxApp mit benutzerdefinierten Gap-Limit-Werten über die Kommandozeile startest.
Diese Methode ist nur für Spezialfälle gedacht oder wenn du dich im Terminal sicher fühlst.

Für die meisten Nutzer empfehlen wir weiterhin die grafische Methode:
Siehe: Gap-Limit in der BitBoxApp anpassen 

Wann du die Kommandozeilen-Methode verwenden solltest

Nutze diese Methode nur, wenn:

• du unter Linux arbeitest und die BitBoxApp mit individuellen Startparametern öffnen musst
• du lieber mit Terminal-Parametern arbeitest statt die UI-Einstellungen zu ändern
• du ein Wiederherstellungsszenario mit vielen ungenutzten oder extern generierten Adressen untersuchst
• du weißt, dass deine vorherige Wallet-Software ungewöhnlich große Address-Gaps verwendet hat

Temporäre Gap-Limit-Overrides

• Die Parameter gelten nur während dieser Sitzung.
• Sobald du die App schließt und normal öffnest, gelten wieder die Standardwerte.
• Dadurch bleibt die Kompatibilität zwischen verschiedenen Wallet-Apps gewahrt und Fehlkonfigurationen werden verhindert.

Empfohlene Startwerte

Starte mit:

• 50 für Empfangsadressen
• 50 für Wechselgeld-Adressen (change)

Wenn nach dem Rescan weiterhin Guthaben fehlt, probiere nacheinander:

• 100
• 150
• 200

Steigere die Werte nur soweit notwendig.

Windows

1. Öffne die Eingabeaufforderung (Command Prompt).
2. Wechsle in den Installationsordner:

   cd "C:\Program Files\BitBox"

3. Starte die App mit angepasstem Gap-Limit:

Nur Receive-Gap setzen:

.\BitBox.exe --gap-limit-receive 50

Nur Change-Gap setzen:

.\BitBox.exe --gap-limit-change 50

Beide Limits setzen:

.\BitBox.exe --gap-limit-receive 50 --gap-limit-change 50

macOS

1. Öffne das Terminal (Programme → Dienstprogramme).
2. Starte die App mit:

Receive-Limit:

open -a BitBox --args --gap-limit-receive 50

Change-Limit:

open -a BitBox --args --gap-limit-change 50

Beide Limits:

open -a BitBox --args --gap-limit-receive 50 --gap-limit-change 50

Linux

Der Befehl hängt davon ab, wie du die BitBoxApp installiert hast.

Paketinstallation (.deb, .rpm)

Wenn über einen Paketmanager installiert, ist das Binary meist als BitBox im PATH verfügbar.

Receive-Limit:

BitBox -gapLimitReceive 50

Change-Limit:

BitBox -gapLimitChange 50

Beide Limits:

BitBox -gapLimitReceive 50 -gapLimitChange 50

Falls der Befehl nicht gefunden wird:
Finde den Pfad mit:

which BitBox
whereis BitBox

Typische Orte: /usr/bin, /usr/local/bin

Beispiel:

/usr/bin/BitBox -gapLimitReceive 50

AppImage

1. Mache die Datei ausführbar:

chmod +x BitBox-[version]-x86_64.AppImage

2. Starte mit:

Receive-Limit:

./BitBox-[version]-x86_64.AppImage -gapLimitReceive 50

Change-Limit:

./BitBox-[version]-x86_64.AppImage -gapLimitChange 50

Beide Limits:

./BitBox-[version]-x86_64.AppImage -gapLimitReceive 50 -gapLimitChange 50

Nach dem Start mit benutzerdefiniertem Gap-Limit

Nach dem Start:

• führt die App einen Rescan mit den erweiterten Suchgrenzen durch
• erscheinen fehlende Transaktionen, wenn sie außerhalb des Standard-Gaps lagen
• kannst du das Limit weiter erhöhen, falls weiterhin etwas fehlt

Die Änderungen bleiben nicht dauerhaft, außer du startest die App wieder mit denselben Parametern.

FAQ

Ist die Kommandozeilen-Methode sicher?

Ja. Es wird lediglich beeinflusst, wie die BitBoxApp die Historie scannt.
Keys, Adressen oder die Wallet-Struktur werden nicht verändert.

Warum sollte ich das statt der UI verwenden?

Die UI ist für die meisten Nutzer ausreichend.
Die Kommandozeile ist sinnvoll für:

• Linux-Nutzer
• automatisierte Fehlersuche
• exotische Wiederherstellungsszenarien
• Fälle, in denen die UI nicht verfügbar ist oder die App nicht normal startet

Kann ich Bitcoin verlieren, wenn Transaktionen außerhalb des Standard-Gaps liegen?

Nein. Die Coins liegen weiterhin sicher auf der Blockchain.
Du musst nur die Scan-Tiefe erhöhen, um sie anzuzeigen.

Bleiben die Änderungen nach einem Neustart erhalten?

Nein. Kommandozeilen-Overrides gelten nur für die jeweilige Sitzung.