Installation af nitropy med pipx#
Denne vejledning forklarer, hvordan du installerer nitropy med pipx. pipx opretter et virtuelt miljø for nitropy. Det betyder, at nitropy og dets afhængigheder ikke kommer i konflikt med andre pakker, der er installeret på dit system.
Bemærk
For Windows-brugere: Windows-understøttelse er stadig eksperimentel - brug den med forsigtighed. Du kan også bruge forkompilerede binære filer eller et MSI-installationsprogram, se Installation af nitropy på Windows.
Installation på Linux#
Ubuntu, Debian#
Du kan installere nitropy sammen med alle andre nødvendige afhængigheder ved at bruge:
sudo apt install pipx && pipx ensurepath && pipx install pynitrokey
Når du har logget ud eller genstartet dit system, vil nitropy nu være tilgængelig.
Bue#
Du kan installere nitropy sammen med alle andre nødvendige afhængigheder ved at bruge:
sudo pacman -S python python-pipx && pipx ensurepath && pipx install pynitrokey
Hvis du allerede har installeret Python på dit system, kan du bare køre:
sudo pacman -S python-pipx && pipx ensurepath && pipx install pynitrokey
Når du har logget ud eller genstartet dit system, vil nitropy nu være tilgængelig.
Installation på andre distributions-/driftssystemer#
Forberedelse#
Python 3.9, 3.10 eller 3.11#
Python er allerede installeret på de fleste macOS- og Linux-systemer eller kan downloades fra python.org. Se Guide til downloading af Python for flere oplysninger.
pip#
Du kan installere pip med dit systems pakkehåndteringsprogram eller med python3 -m ensurepip
. Se pip-installationsvejledning for at få flere oplysninger.
pipx#
Før du installerer nitropy, skal du installere og konfigurere pipx:
python3 -m pip install --user pipx
python3 -m pipx ensurepath
Se pipx Installation Guide for flere oplysninger.
Bemærk
For Linux-brugere - i øjeblikket genererer en forbigående afhængighed (oscrypto
) problemer på nogle Linux-distrubutioner. Det respektive GitHub issue dokumenterer den aktuelt nødvendige workaround:
pipx inject --pip-args="--upgrade --force" pynitrokey "oscrypto @ git+https://github.com/wbond/oscrypto.git@1547f535001ba568b239b8797465536759c742a3"
Installation#
Nu kan du installere nitropy fra pakken pynitrokey:
pipx install pynitrokey
nitropy er nu tilgængelig i din sti:
nitropy --help
Opgradering#
Du kan opgradere pakken med følgende kommando:
pipx upgrade pynitrokey
Fejlfinding#
Hvis du støder på problemer, skal du sikre dig, at du bruger den nyeste version ved at sammenligne resultatet af nitropy version
med release-listen på GitHub. Hvis en opgradering ikke installerer den nyeste version, kan det være et af følgende problemer, du støder på.
Forkert Python-version#
nitropy kræver Python 3.9 eller 3.10. Hvis din standard Python-installation er ældre eller nyere end dette og ikke kan opdateres, skal du desuden installere Python 3.9 og angive navnet på den eksekverbare Python-fil, når du kalder pipx, for eksempel:
$ pipx install --python python3.9 pynitrokey
libusb-1.0.0.dylib ikke fundet#
Når du kører nitropy på macOS, kan du få vist en fejlmeddelelse, der angiver, at der mangler en libusb-1.0.dylib-fil. Dette kan rettes ved at installere libusb manuelt, f.eks. med homebrew:
$ brew install libusb
Brugsanvisninger#
Alle platforme#
Hvis du ønsker at bruge nitropy med en Nitrokey Pro- eller Nitrokey Storage-enhed, skal du også installere libnitrokey.
Windows#
Windows-understøttelse er stadig eksperimentel - brug den med forsigtighed.
Du skal muligvis køre nitropy med administratorrettigheder for at kunne oprette forbindelse til en enhed.
Linux#
På Linux-systemer skal du også bruge Nitrokey udev-reglerne. Disse leveres med libnitrokey. Alternativt kan du installere dem manuelt:
wget https://raw.githubusercontent.com/Nitrokey/nitrokey-udev-rules/refs/heads/main/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/
Se Opsætning af udev-reglerne for flere oplysninger.
Usage of PIV features#
For at kunne bruge PIV-funktionaliteten i nitropy (nitropy nk3 piv
) skal du også installere afhængigheden pyscard
:
pipx install pynitrokey[pcsc]
Næste skridt#
Du kan finde flere oplysninger om brugen af nitropy i disse vejledninger:
For Linux: Firmwareopdatering
For Mac: Firmwareopdatering
For Windows: Firmwareopdatering