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.

Installation unter Linux#

Ubuntu, Debian#

Sie können nitropy zusammen mit allen anderen erforderlichen Abhängigkeiten installieren, indem Sie:

sudo apt install pipx && pipx ensurepath && pipx install pynitrokey

Nach der Abmeldung oder dem Neustart Ihres Systems ist Nitropy nun verfügbar.

Arch#

Sie können nitropy zusammen mit allen anderen erforderlichen Abhängigkeiten installieren, indem Sie:

sudo pacman -S python python-pipx && pipx ensurepath && pipx install pynitrokey

Wenn Sie Python bereits auf Ihrem System installiert haben, können Sie einfach Folgendes ausführen:

sudo pacman -S python-pipx && pipx ensurepath && pipx install pynitrokey

Nach der Abmeldung oder dem Neustart Ihres Systems ist Nitropy nun verfügbar.

Installation auf anderen Verteilern/Betriebssystemen#

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. Der entsprechende GitHub issue dokumentiert die derzeit benötigte Abhilfe:

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

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/nitrokey-udev-rules/refs/heads/main/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/

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

Usage of PIV features#

Um die PIV-Funktionalität von nitropy (nitropy nk3 piv) nutzen zu können, müssen Sie auch die Abhängigkeit pyscard installieren:

pipx install pynitrokey[pcsc]

Nächste Schritte#

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