Installer nitropy avec pipx

Ce guide explique comment installer nitropy avec pipx. pipx crée un environnement virtuel pour nitropy. Cela signifie que nitropy et ses dépendances n’entrent pas en conflit avec d’autres paquets installés sur votre système.

Note

Pour les utilisateurs de Windows: Le support de Windows est encore expérimental – veuillez l’utiliser avec prudence. Vous pouvez également utiliser des binaires précompilés ou un installateur MSI, voir Installation de nitropy sous Windows.

Installation sous Linux

Ubuntu, Debian

Vous pouvez installer nitropy avec toutes les autres dépendances requises en utilisant: :

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

Après la déconnexion ou le redémarrage de votre système, nitropy sera désormais disponible.

Arche

Vous pouvez installer nitropy avec toutes les autres dépendances requises en utilisant: :

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

Si vous avez déjà installé Python sur votre système, vous pouvez simplement lancer: :

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

Après la déconnexion ou le redémarrage de votre système, nitropy sera désormais disponible.

Fedora

Vous pouvez installer nitropy avec toutes les autres dépendances requises en utilisant: :

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

Si vous avez déjà installé Python sur votre système, vous pouvez simplement lancer: :

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

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

Mageia

Vous pouvez installer nitropy avec toutes les autres dépendances requises en utilisant: :

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

Si vous avez déjà installé Python sur votre système, vous pouvez simplement lancer: :

$ 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 sur d’autres distributions/systèmes d’exploitation

Préparation

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

Vous pouvez installer pip avec le gestionnaire de paquets de votre système ou avec python3 -m ensurepip. Consultez le Guide d’installation de pip pour plus d’informations.

pipx

Avant d’installer nitropy, vous devez installer et configurer pipx: :

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

Voir le pipx Installation Guide pour plus d’informations.

Installation

Maintenant vous pouvez installer nitropy à partir du paquet pynitrokey: :

$ pipx install pynitrokey

nitropy est maintenant disponible dans votre chemin: :

$ nitropy --help

Mise à niveau

Vous pouvez mettre à jour le paquet avec la commande suivante: :

$ pipx upgrade pynitrokey

Dépannage

Si vous rencontrez des problèmes, veuillez vous assurer que vous utilisez la dernière version en comparant la sortie de nitropy version avec la release list sur GitHub. Si une mise à niveau n’installe pas la dernière version, vous rencontrez peut-être l’un des problèmes suivants.

Mauvaise version de Python

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 non trouvé

Lorsque vous exécutez nitropy sous macOS, vous pouvez voir un message d’erreur indiquant que le fichier libusb-1.0.dylib est manquant. Ceci peut être corrigé en installant manuellement libusb, par exemple avec homebrew: :

$ brew install libusb

Notes d’utilisation

Toutes les plateformes

Si vous voulez utiliser nitropy avec un dispositif Nitrokey Pro ou Nitrokey Storage, vous devez également installer libnitrokey.

Windows

La prise en charge de Windows est encore expérimentale - veuillez l’utiliser avec prudence.

Vous devrez peut-être exécuter nitropy avec des droits d’administrateur pour pouvoir vous connecter à un appareil.

Linux

Sur les systèmes Linux, vous avez également besoin des règles udev Nitrokey. Elles sont livrées avec libnitrokey. Alternativement, vous pouvez les installer manuellement : :

$ wget https://raw.githubusercontent.com/Nitrokey/nitrokey-udev-rules/refs/heads/main/41-nitrokey.rules
$ sudo mv 41-nitrokey.rules /etc/udev/rules.d/

Voir Mise en place des règles udev pour plus d’informations.

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]

Les prochaines étapes

Vous trouverez de plus amples informations sur l’utilisation de la nitropy dans ces guides :