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.

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

Arm stöds inte#

För närvarande kan de senaste nitropy-versionerna inte installeras på Arm-plattformar på grund av ett beroendeproblem (GitHub-fråga). Som en lösning kan du använda en x86 Python-installation i en Rosetta-terminal enligt beskrivningen i denna diskussion).

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/libnitrokey/master/data/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/

Se Inställning av udev-reglerna för mer information.

Nästa steg#

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