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.

Fedora

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

$ sudo dnf install python pipx && pipx ensurepath && pipx install pynitrokey

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

$ sudo dnf install pipx && pipx ensurepath && pipx install pynitrokey

After logging our or restarting your system, nitropy will now be available.

Mageia

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

$ sudo dnf install python python3-pip && pip install --user pipx && pipx ensurepath && pipx install pynitrokey

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

$ sudo dnf install python3-pip && pip install --user pipx && pipx ensurepath && pipx install pynitrokey

After logging our or restarting your system, nitropy will now be available.

Installation auf anderen Verteilern/Betriebssystemen

Vorbereitung

Python

Python is already installed on most macOS and Linux systems or can be downloaded from python.org. Currently the supported Python versions are 3.9, 3.10, 3.11, 3.12 and 3.13. See the Downloading Python Guide for more information.

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.

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

If your default Python installation is not in the supported versions list above, you need to specify an alternative to pipx. Install a supported version of Python and specify the name of its Python executable when calling pipx, for example:

$ 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

To be able to use the PIV functionality of nitropy (nitropy nk3 piv), you need to install the pyscard dependency too:

$ pipx install pynitrokey[pcsc]

Nächste Schritte

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