Installeren van nitropy met pipx

Deze gids legt uit hoe u nitropy installeert met ` pipx <https://pypa.github.io/pipx/>`__. pipx creëert een virtuele omgeving voor nitropy. Dit betekent dat nitropy en zijn afhankelijkheden niet conflicteren met andere pakketten die op uw systeem zijn geïnstalleerd.

Notitie

Voor Windows gebruikers: Windows ondersteuning is nog experimenteel – gebruik het met de nodige voorzichtigheid. U kunt ook voorgecompileerde binaries of een MSI-installatieprogramma gebruiken, zie Installeren van nitropy op Windows.

Installatie op Linux

Ubuntu, Debian

Je kunt nitropy samen met alle andere vereiste afhankelijkheden installeren met:

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

Nadat je bent uitgelogd of je systeem opnieuw is opgestart, is nitropy nu beschikbaar.

Arch

Je kunt nitropy samen met alle andere vereiste afhankelijkheden installeren met:

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

Als u Python al op uw systeem hebt geïnstalleerd, kunt u gewoon uitvoeren:

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

Nadat je bent uitgelogd of je systeem opnieuw is opgestart, is nitropy nu beschikbaar.

Installatie op andere distributies/bedieningssystemen

Voorbereiding

Python 3.9, 3.10 of 3.11

Python is al geïnstalleerd op de meeste macOS- en Linux-systemen of kan worden gedownload van python.org. Zie de gids Python downloaden voor meer informatie.

pip

U kunt pip installeren met uw systeempakketbeheerder of met python3 -m ensurepip. Zie de pip installatiegids voor meer informatie.

pipx

Voordat je nitropy installeert, moet je pipx installeren en configureren:

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

Zie de pipx Installatiegids voor meer informatie.

Notitie

Voor Linux-gebruikers - momenteel genereert een tijdelijke afhankelijkheid (oscrypto) problemen op sommige Linux-distrubuties. De respectievelijke GitHub issue documenteert de momenteel benodigde workaround:

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

Installatie

Nu kun je nitropy installeren vanuit het pynitrokey pakket:

pipx install pynitrokey

nitropy is nu beschikbaar in uw pad:

nitropy --help

Upgrade

U kunt het pakket upgraden met het volgende commando:

pipx upgrade pynitrokey

Problemen oplossen

Als u problemen ondervindt, controleer dan of u de laatste versie gebruikt door de uitvoer van nitropy version te vergelijken met de releaselijst op GitHub. Als een upgrade niet de laatste versie installeert, loop je misschien tegen een van de volgende problemen aan.

Verkeerde Python-versie

nitropy vereist Python 3.9 of 3.10. Als uw standaard Python-installatie ouder of nieuwer is dan dat en niet kan worden bijgewerkt, moet u aanvullend Python 3.9 installeren en de naam van het Python-uitvoerbestand daarvan opgeven wanneer u pipx aanroept, bijvoorbeeld:

$ pipx install --python python3.9 pynitrokey

libusb-1.0.dylib niet gevonden

Wanneer u nitropy op macOS draait, kunt u een foutmelding zien die aangeeft dat het bestand libusb-1.0.dylib ontbreekt. Dit kan verholpen worden door libusb handmatig te installeren, bijvoorbeeld met homebrew:

$ brew install libusb

Opmerkingen over het gebruik

Alle platformen

Als je nitropy wilt gebruiken met een Nitrokey Pro of Nitrokey Storage apparaat, moet je ook libnitrokey installeren.

Windows

Windows ondersteuning is nog experimenteel – gebruik het met voorzichtigheid.

Het kan zijn dat je nitropy met administrator rechten moet draaien om verbinding te kunnen maken met een apparaat.

Linux

Op Linux systemen heb je ook de Nitrokey udev regels nodig. Deze worden geleverd met libnitrokey. U kunt ze ook handmatig installeren:

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

Zie De udev-regels instellen voor meer informatie.

Usage of PIV features

Om de PIV functionaliteit van nitropie te kunnen gebruiken (nitropy nk3 piv), moet je ook de pyscard afhankelijkheid installeren:

pipx installeer pynitrokey[pcsc]

Volgende stappen

Meer informatie over het gebruik van nitropie vindt u in deze gidsen: