Installation von nitropy mit pipx#

Diese Anleitung erklärt, wie man nitropy mit pipx installiert. pipx erstellt eine virtuelle Umgebung für nitropy. Das bedeutet, dass nitropy und seine Abhängigkeiten nicht mit anderen auf Ihrem System installierten Paketen in Konflikt geraten.

Bemerkung

Für Windows-Benutzer: Die Windows-Unterstützung ist noch experimentell - bitte mit Vorsicht verwenden. Sie können auch vorkompilierte Binärdateien oder ein MSI-Installationsprogramm verwenden, siehe Installation von nitropy unter Windows.

Vorbereitung#

Python 3.9, 3.10 oder 3.11#

Python ist auf den meisten macOS- und Linux-Systemen bereits installiert oder kann von python.org heruntergeladen werden. Weitere Informationen finden Sie in der Anleitung zum Herunterladen von Python.

pip#

Sie können pip mit Ihrem Systempaketmanager oder mit python3 -m ensurepip installieren. Siehe die pip Installationsanleitung für weitere Informationen.

pipx#

Bevor Sie nitropy installieren, müssen Sie pipx installieren und konfigurieren:

python3 -m pip install --user pipx
python3 -m pipx ensurepath

Weitere Informationen finden Sie in der pipx Installationsanleitung.

Bemerkung

Für Linux-Benutzer - derzeit eine vorübergehende Abhängigkeit (oscrypto) erzeugt Probleme auf einigen Linux-Distributionen. Die entsprechende GitHub-Ausgabe dokumentiert den derzeit benötigten Workaround:

pipx inject --pip-args="--upgrade --force" pynitrokey "oscrypto @ git+https://github.com/wbond/oscrypto.git@1547f535001ba568b239b8797465536759c742a3"

Installation#

Jetzt können Sie nitropy aus dem Paket pynitrokey installieren:

pipx install pynitrokey

nitropy ist jetzt in Ihrem Pfad verfügbar:

nitropy --help

Upgrade#

Sie können das Paket mit dem folgenden Befehl aktualisieren:

pipx upgrade pynitrokey

Fehlersuche#

Wenn Sie auf Probleme stoßen, stellen Sie bitte sicher, dass Sie die neueste Version verwenden, indem Sie die Ausgabe von nitropy version mit der Release-Liste auf GitHub vergleichen. Wenn bei einem Upgrade nicht die neueste Version installiert wird, liegt möglicherweise eines der folgenden Probleme vor.

Falsche Python-Version#

nitropy benötigt Python 3.9 oder 3.10. Wenn Ihre Standard-Python-Installation älter oder neuer ist und nicht aktualisiert werden kann, müssen Sie zusätzlich Python 3.9 installieren und den Namen der ausführbaren Python-Datei beim Aufruf von pipx angeben, zum Beispiel:

$ pipx install --python python3.9 pynitrokey

Arm wird nicht unterstützt#

Derzeit können aktuelle Nitropy-Versionen aufgrund eines Abhängigkeitsproblems nicht auf Arm-Plattformen installiert werden (GitHub issue). Als Workaround kann man eine x86-Python-Installation in einem Rosetta-Terminal verwenden, wie in dieser Diskussion) beschrieben.

libusb-1.0.dylib nicht gefunden#

Wenn Sie nitropy unter macOS ausführen, kann eine Fehlermeldung erscheinen, die auf eine fehlende libusb-1.0.dylib-Datei hinweist. Dies kann durch die manuelle Installation von libusb behoben werden, z. B. mit homebrew:

$ brew install libusb

Verwendungshinweise#

Alle Plattformen#

Wenn Sie nitropy mit einem Nitrokey Pro oder Nitrokey Storage Gerät verwenden wollen, müssen Sie auch libnitrokey installieren.

Windows#

Die Windows-Unterstützung ist noch experimentell - bitte verwenden Sie sie mit Bedacht.

Möglicherweise müssen Sie nitropy mit Administratorrechten ausführen, um eine Verbindung zu einem Gerät herstellen zu können.

Linux#

Auf Linux-Systemen benötigen Sie außerdem die Nitrokey-udev-Regeln. Diese werden mit libnitrokey ausgeliefert. Alternativ können Sie sie auch manuell installieren:

wget https://raw.githubusercontent.com/Nitrokey/libnitrokey/master/data/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/

Siehe Die udev-Regeln für nitropy einrichten für weitere Informationen.

Nächste Schritte#

Weitere Informationen zur Verwendung von Nitropy finden Sie in diesen Leitfäden: