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.

Installation sur d’autres distributions/systèmes d’exploitation#

Préparation#

Python 3.9, 3.10 ou 3.11#

Python est déjà installé sur la plupart des systèmes macOS et Linux ou peut être téléchargé sur python.org. Consultez le Guide de téléchargement de Python pour plus d’informations.

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.

Note

Pour les utilisateurs de Linux - actuellement une dépendance transitoire (oscrypto) génère des problèmes sur certaines distributions Linux. Le numéro GitHub documente la solution de contournement actuellement nécessaire: :

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

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#

nitropy nécessite Python 3.9 ou 3.10. Si votre installation Python par défaut est plus ancienne ou plus récente que cela et ne peut pas être mise à jour, vous devez installer en plus Python 3.9 et spécifier le nom de son exécutable Python lorsque vous appelez pipx, par exemple : :

$ pipx install --python python3.9 pynitrokey

ARM non pris en charge#

Actuellement, les versions récentes de nitropy ne peuvent pas être installées sur les plateformes Arm en raison d’un problème de dépendance (GitHub issue). Comme solution de contournement, vous pouvez utiliser une installation Python x86 dans un terminal Rosetta comme décrit dans cette discussion).

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 :