Instalarea nitropy cu pipx¶

Acest ghid explică cum să instalați nitropy cu pipx. pipx creează un mediu virtual pentru nitropy. Acest lucru înseamnă că nitropy și dependențele sale nu intră în conflict cu alte pachete instalate pe sistemul dumneavoastră.

Notă

Pentru utilizatorii de Windows: Suportul pentru Windows este încă experimental - vă rugăm să îl utilizați cu precauție. Puteți utiliza, de asemenea, binare precompilate sau un program de instalare MSI, consultați Instalarea nitropy pe Windows.

Instalare pe Linux¶

Ubuntu, Debian¶

Puteți instala nitropy împreună cu toate celelalte dependențe necesare folosind:

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

După ce vă deconectați sau reporniți sistemul, nitropy va fi acum disponibil.

Arch¶

Puteți instala nitropy împreună cu toate celelalte dependențe necesare folosind:

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

Dacă ați instalat deja Python pe sistemul dumneavoastră, puteți rula pur și simplu:

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

După ce vă deconectați sau reporniți sistemul, nitropy va fi acum disponibil.

Instalare pe alte sisteme de distribuție/operare¶

Pregătire¶

Python 3.9, 3.10 sau 3.11¶

Python este deja instalat pe majoritatea sistemelor macOS și Linux sau poate fi descărcat de pe python.org. Consultați Ghidul de descărcare a Python pentru mai multe informații.

pip¶

Puteți instala pip cu managerul de pachete al sistemului sau cu python3 -m ensurepip. Consultați Ghidul de instalare pip pentru mai multe informații.

pipx¶

Înainte de a instala nitropy, trebuie să instalați și să configurați pipx:

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

Pentru mai multe informații, consultați pipx Installation Guide.

Notă

Pentru utilizatorii Linux - în prezent o dependență tranzitorie (oscrypto) generează probleme pe unele distribuții Linux. Problema respectivă GitHub documentează soluția de rezolvare necesară în prezent:

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

Instalare¶

Acum puteți instala nitropy din pachetul pynitrokey:

pipx install pynitrokey

nitropy este acum disponibil în calea ta:

nitropy --help

Actualizare¶

Puteți actualiza pachetul cu următoarea comandă:

pipx upgrade pynitrokey

Depanare¶

Dacă întâmpinați probleme, asigurați-vă că folosiți cea mai recentă versiune comparând rezultatul nitropy version cu lista de versiuni de pe GitHub. Dacă o actualizare nu instalează cea mai recentă versiune, este posibil să vă confruntați cu una dintre următoarele probleme.

Versiune Python greșită¶

nitropy necesită Python 3.9 sau 3.10. Dacă instalarea implicită a Python este mai veche sau mai nouă decât aceasta și nu poate fi actualizată, trebuie să instalați suplimentar Python 3.9 și să specificați numele executabilului său Python atunci când apelați pipx, de exemplu:

$ pipx install --python python3.9 pynitrokey

libusb-1.0.dylib nu a fost găsit¶

Când rulați nitropy pe macOS, este posibil să vedeți un mesaj de eroare care indică faptul că lipsește un fișier libusb-1.0.dylib. Acest lucru poate fi rezolvat prin instalarea manuală a libusb, de exemplu, cu homebrew:

$ brew install libusb

Note de utilizare¶

Toate platformele¶

Dacă doriți să utilizați nitropy cu un dispozitiv Nitrokey Pro sau Nitrokey Storage, trebuie să instalați și libnitrokey.

Windows¶

Suportul pentru Windows este încă experimental - vă rugăm să îl utilizați cu prudență.

Este posibil să trebuiască să rulați nitropy cu drepturi de administrator pentru a vă putea conecta la un dispozitiv.

Linux¶

Pe sistemele Linux, aveți nevoie și de regulile Nitrokey udev. Acestea sunt livrate cu libnitrokey. Alternativ, le puteți instala manual:

wget https://raw.githubusercontent.com/Nitrokey/nitrokey-udev-rules/refs/heads/main/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/

Consultați Configurarea regulilor udev pentru mai multe informații.

Usage of PIV features¶

Pentru a putea utiliza funcționalitatea PIV a nitropiei (nitropy nk3 piv), trebuie să instalați și dependența pyscard:

pipx install pynitrokey[pcsc]

Etapele următoare¶

Puteți găsi mai multe informații despre utilizarea nitropiei în aceste ghiduri: