Lässt sich die BitBoxApp unter Linux nicht installieren oder öffnen, ist die angezeigte Fehlermeldung der beste Ausgangspunkt. Ein Installationsfehler in der Paketverwaltung erfordert andere Schritte als eine AppImage-Datei, die nicht startet, oder eine App, die sich sofort wieder schliesst.

Wähle den Abschnitt, der zu deinem Problem passt:

• Der Download ist unvollständig oder du bist unsicher, welche Datei du brauchst
• Ein DEB- oder RPM-Paket lässt sich nicht installieren
• Die AppImage-Datei startet nicht
• Sicherheitssoftware oder eine Geräterichtlinie blockiert die Datei
• Die installierte BitBoxApp öffnet sich nicht

Download und Paketformat prüfen

Prüfe, ob die Datei von der offiziellen BitBoxApp-Downloadseite stammt und vollständig heruntergeladen wurde. Wurde der Download unterbrochen, lösche die unvollständige Datei und lade sie erneut herunter. Meldet dein Browser oder deine Sicherheitssoftware eine Bedrohung, folge zuerst dem Abschnitt zu blockierten Dateien, bevor du es erneut versuchst.

Die Datei muss zu deinem Linux-System passen. Die offiziellen Linux-Downloads sind für Computer mit x86-64-Architektur gedacht, auch amd64 genannt. Ein Computer mit 64-Bit-ARM-Architektur benötigt eine für diese Architektur erstellte Programmdatei. Prüfe die unterstützten Betriebssysteme, bevor du fortfährst – insbesondere, wenn deine Distribution oder Version dort nicht aufgeführt ist.

• DEB: Verwende das .deb-Paket für Debian oder Ubuntu.
• RPM: Verwende das .rpm-Paket für Fedora oder openSUSE.
• AppImage: Mit der .AppImage-Datei kannst du die App ohne systemweite Paketinstallation ausführen. Auch dafür brauchst du eine kompatible Linux-Umgebung.

Die regulären Schritte findest du unter BitBoxApp unter Linux installieren oder BitBoxApp AppImage unter Linux ausführen. Eine AppImage-Datei garantiert keine Kompatibilität mit einem nicht unterstützten System.

Bevor du die Datei ausführst, kannst du ihre Prüfsumme überprüfen oder ihre Signatur verifizieren. Schlägt die Prüfung fehl, öffne oder installiere die Datei nicht und kontaktiere den Support.

Wenn sich ein DEB- oder RPM-Paket nicht installieren lässt

Öffne das passende Paket mit der Paketverwaltung deines Systems. Schlägt die Installation fehl, notiere die vollständige Fehlermeldung. Sie bestimmt den nächsten Schritt:

• Falsches Paketformat oder falsche Architektur: Prüfe den Download wie oben beschrieben. Erzwinge die Installation nicht auf einem inkompatiblen System.
• Administratorrechte erforderlich: Bestätige die Installation über die übliche Sicherheitsabfrage deines Systems nur, wenn du die Datei von der offiziellen Downloadseite geladen hast. Fehlen dir auf einem verwalteten Arbeits- oder Schulcomputer die nötigen Rechte, wende dich an die zuständige IT-Administration.
• Eine andere Installation oder ein Update läuft: Warte, bis dieser Vorgang abgeschlossen ist, und versuche dann erneut, das BitBoxApp-Paket zu installieren. Lösche keine Sperrdateien der Paketverwaltung.
• Eine Abhängigkeit fehlt, es gibt einen Paketkonflikt oder einen anderen Fehler: Notiere die vollständige Meldung und kontaktiere den BitBox Support. Erzwinge die Installation nicht und entferne keine Systempakete, um den Fehler zu umgehen.

Ist die Installation abgeschlossen, öffne die BitBoxApp über das Anwendungsmenü. Öffnet sie sich nicht, fahre mit den Schritten für Startprobleme fort.

Wenn die AppImage-Datei nicht startet

Eine AppImage-Datei startest du direkt, ohne ein Paket zu installieren. Prüfe zuerst, ob die offizielle Datei die nötige Ausführungsberechtigung hat:

1. Klicke im Dateimanager mit der rechten Maustaste auf die AppImage-Datei und wähle Eigenschaften.
2. Aktiviere unter Berechtigungen oder Zugriffsrechte die Option, mit der sich die Datei als Programm ausführen lässt. Je nach Dateimanager heisst sie beispielsweise Datei als Programm ausführen; die Beschriftung kann abweichen.
3. Schliesse das Eigenschaftenfenster und starte die AppImage erneut mit einem Doppelklick.

Fehlt diese Option, nutze die Terminal-Anleitung im AppImage-Artikel. Lässt sich die Datei weiterhin nicht öffnen, kann ein Start über das Terminal die Fehlermeldung sichtbar machen:

1. Öffne ein Terminal in dem Ordner, in dem die heruntergeladene AppImage-Datei liegt.
2. Gib den folgenden Befehl ein. Ersetze VERSION durch die Versionsnummer im Namen deiner heruntergeladenen Datei. Behalte die Anführungszeichen und das ./ am Anfang bei.

./"BitBox-VERSION-x86_64.AppImage"

Öffnet sich die BitBoxApp, ist das Startproblem behoben. Bei einer FUSE-Fehlermeldung hilft der nächste Abschnitt. Erscheint eine andere Meldung oder weiterhin kein Fenster, halte die Terminal-Ausgabe fest und kontaktiere den Support.

Wenn die Fehlermeldung FUSE oder libfuse.so.2 nennt

Eine Meldung wie AppImages require FUSE to run oder ein Hinweis auf eine fehlende libfuse.so.2 deutet auf ein Problem mit der FUSE-Bibliothek hin. FUSE ermöglicht Linux den Zugriff auf den Inhalt der AppImage-Datei. Die Ausführungsberechtigung allein behebt eine fehlende Bibliothek nicht.

Fehlt unter Ubuntu die FUSE-2-Bibliothek, installiere das passende Paket für genau deine Ubuntu-Version aus den regulären Paketquellen:

• Ubuntu 22.04: sudo apt install libfuse2
• Ubuntu 24.04: sudo apt install libfuse2t64

Prüfe die vorgeschlagenen Änderungen der Paketverwaltung, bevor du sie bestätigst. Sollen Systempakete entfernt werden, brich ab. Ersetze oder entferne FUSE 3 nicht. Für eine andere Distribution oder Ubuntu-Version nutze die AppImage-Dokumentation zu FUSE-Problemen (Englisch) oder frage die IT-Administration nach dem passenden Paket.

Starte dieselbe AppImage-Datei erneut, sobald die Bibliothek installiert ist. Bleibt der Fehler bestehen oder erscheint eine andere Meldung, sende diese an den Support, statt die Installation zu wiederholen.

Wenn Sicherheitssoftware oder eine Richtlinie die App blockiert

Meldet ein Browser oder ein Sicherheitsprogramm eine Bedrohung, verschiebt die Datei in Quarantäne oder blockiert ihre Ausführung, notiere die genaue Warnung und gegebenenfalls den Namen der erkannten Bedrohung. Stelle eine als Bedrohung erkannte Datei nicht wieder her und gib sie nicht frei. Deaktiviere keine Schutzfunktion und wechsle nicht die Downloadmethode, um die Blockade zu umgehen. Wende dich an den BitBox Support, bevor du die Datei ausführst.

Auf einem verwalteten Arbeits- oder Schulcomputer sollte die IT-Administration die Einschränkungen für Installation oder Ausführung prüfen. Eine AppImage-Datei ist kein Weg, um Geräterichtlinien zu umgehen.

Wenn sich die installierte BitBoxApp nicht öffnet

Dieser Abschnitt gilt, wenn die Paketverwaltung eine abgeschlossene Installation meldet, aber kein Fenster erscheint oder sich die App sofort wieder schliesst. Kläre zuerst alle Sicherheitswarnungen.

1. Schliesse alle offenen BitBoxApp-Fenster und versuche, die App erneut zu öffnen.
2. Öffnet sie sich weiterhin nicht, öffne ein Terminal und gib BitBox ein. Achte auf die Gross- und Kleinschreibung: Die offiziellen DEB- und RPM-Pakete verwenden diesen Startbefehl.
3. Halte Fehlermeldungen fest. Öffnet sich die App weiterhin nicht oder meldet das Terminal, dass der Befehl nicht gefunden wurde, kontaktiere den Support mit diesem Ergebnis.

Starte die App mit deinem normalen Benutzerkonto. Verwende keine Administratorrechte, um einen Startfehler zu umgehen. Lösche dafür auch keine BitBoxApp-Daten und setze deine BitBox nicht zurück.

Sobald sich die BitBoxApp öffnet

Das Installations- oder Startproblem ist behoben, wenn sich die BitBoxApp normal öffnet.

• Zeigt sie eine ältere Version an, folge der Anleitung zum Aktualisieren der BitBoxApp. Du musst die App dafür nicht als ersten Schritt deinstallieren.
• Erkennt die geöffnete App deine BitBox nicht, nutze die Anleitung zu USB-Verbindungsproblemen unter Linux. Sie behandelt USB-Berechtigungen und udev-Regeln.

BitBox Support kontaktieren

Wende dich an den BitBox Support, wenn die passenden Schritte den Fehler nicht beheben, eine fehlende Abhängigkeit oder ein Paketkonflikt die Installation verhindert oder eine erkannte Bedrohung noch nicht geklärt ist. Beziehe bei einem verwalteten Computer auch die IT-Administration ein.

Damit der Support das Problem nachvollziehen kann, sende folgende Angaben:

• deine Linux-Distribution, deren Version und, falls bekannt, die Prozessorarchitektur;
• den vollständigen Namen der heruntergeladenen Datei und das verwendete Format: DEB, RPM oder AppImage;
• ob bereits die Installation fehlschlägt oder sich die App erst danach nicht öffnen lässt;
• die genaue Fehlermeldung, den Namen der erkannten Bedrohung oder die relevante Terminal-Ausgabe;
• ob du einen privaten oder einen von Arbeit oder Schule verwalteten Computer nutzt;
• ob du Wayland oder X11 verwendest, falls bekannt; und
• welche Schritte du bereits versucht hast.

Teile nur die relevante Fehlermeldung oder einen auf den Fehler zugeschnittenen Screenshot und entferne persönliche Angaben. Sende niemals Wiederherstellungswörter, ein Wallet-Backup, Passwörter, Passphrasen, private Schlüssel oder Authentifizierungscodes.