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

Arm ikke understøttet#

I øjeblikket kan nyere nitropy-versioner ikke installeres på Arm-platforme på grund af et afhængighedsproblem (GitHub issue). Som en workaround kan du bruge en x86 Python-installation i en Rosetta-terminal som beskrevet i denne diskussion).

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#

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]

Næste skridt#

Du kan finde flere oplysninger om brugen af nitropy i disse vejledninger: