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: