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

Arm Niet ondersteund#

Momenteel kunnen recente nitropy-versies niet worden geïnstalleerd op Arm-platforms vanwege een afhankelijkheidsprobleem (GitHub issue). Als workaround kun je een x86 Python installatie gebruiken in een Rosetta terminal zoals beschreven in deze discussie).

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: