Installera nitropy med pipx

Den här guiden förklarar hur du installerar nitropy med pipx. pipx skapar en virtuell miljö för nitropy. Detta innebär att nitropy och dess beroenden inte kommer i konflikt med andra paket som är installerade på ditt system.

Observera

För Windows-användare: Stödet för Windows är fortfarande experimentellt - använd det med försiktighet. Du kan också använda förkompilerade binärer eller ett MSI-installationsprogram, se Installera nitropy på Windows.

Installation på Linux

Ubuntu, Debian

Du kan installera nitropy tillsammans med alla andra nödvändiga beroenden genom att använda:

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

Efter att du loggat ut eller startat om ditt system kommer nitropy nu att vara tillgängligt.

Båge

Du kan installera nitropy tillsammans med alla andra nödvändiga beroenden genom att använda:

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

Om du redan har installerat Python på ditt system kan du helt enkelt köra:

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

Efter att du loggat ut eller startat om ditt system kommer nitropy nu att vara tillgängligt.

Installation på andra distributions-/operativsystem

Förberedelse

Python 3.9, 3.10 eller 3.11

Python är redan installerat på de flesta macOS- och Linuxsystem eller kan laddas ner från python.org. Se Guiden för nedladdning av Python för mer information.

pip

Du kan installera pip med systemets pakethanterare eller med python3 -m ensurepip. Se pip installationsguide för mer information.

pipx

Innan du installerar nitropy måste du installera och konfigurera pipx:

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

Mer information finns i pipx Installationsguide.

Observera

För Linux-användare - för närvarande genererar ett övergående beroende (oscrypto) problem på vissa Linux-distributioner. Den aktuella GitHub-utgåvan dokumenterar den lösning som för närvarande behövs:

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

Installation

Nu kan du installera nitropy från paketet pynitrokey:

pipx install pynitrokey

nitropy finns nu i din sökväg:

nitropy --help

Uppgradera

Du kan uppgradera paketet med följande kommando:

pipx upgrade pynitrokey

Felsökning

Om du stöter på problem kan du kontrollera att du använder den senaste versionen genom att jämföra resultatet av nitropy version med releaselistan på GitHub. Om en uppgradering inte installerar den senaste versionen kan det vara ett av följande problem.

Fel Python-version

nitropy kräver Python 3.9 eller 3.10. Om din standardinstallation av Python är äldre eller nyare än så och inte kan uppdateras, måste du dessutom installera Python 3.9 och ange namnet på dess Python-körbara fil när du anropar pipx, till exempel:

$ pipx install --python python3.9 pynitrokey

libusb-1.0.dylib inte hittad

När du kör nitropy på macOS kan du få ett felmeddelande om att det saknas en libusb-1.0.dylib-fil. Detta kan åtgärdas genom att manuellt installera libusb, t.ex. med homebrew:

$ brew install libusb

Anmärkningar om användning

Alla plattformar

Om du vill använda nitropy med en Nitrokey Pro- eller Nitrokey Storage-enhet måste du också installera libnitrokey.

Windows 10

Stödet för Windows är fortfarande experimentellt - använd det med försiktighet.

Du kan behöva köra nitropy med administratörsrättigheter för att kunna ansluta till en enhet.

Linux

På Linuxsystem behöver du också Nitrokey udev-reglerna. Dessa levereras med libnitrokey. Alternativt kan du installera dem manuellt:

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 Inställning av udev-reglerna för mer information.

Usage of PIV features

För att kunna använda PIV-funktionaliteten i nitropy (nitropy nk3 piv) måste du också installera beroendet pyscard:

pipx installera pynitrokey[pcsc]

Nästa steg

Du hittar mer information om hur du använder nitropy i dessa guider: