Nitropyn asentaminen pipx:llä

Tässä oppaassa kerrotaan, miten nitropy asennetaan pipx. pipx luo virtuaalisen ympäristön nitropylle. Tämä tarkoittaa, että nitropy ja sen riippuvuudet eivät ole ristiriidassa muiden järjestelmään asennettujen pakettien kanssa.

Muista

Windows-käyttäjille: Windows-tuki on vielä kokeellinen - käytä sitä varoen. Voit myös käyttää valmiiksi käännettyjä binääripaketteja tai MSI-asennusohjelmaa, katso Nitropyn asentaminen Windowsissa.

Asennus Linuxiin

Ubuntu, Debian

Voit asentaa nitropyn ja kaikki muut tarvittavat riippuvuudet käyttämällä:

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

Kun olet kirjautunut ulos tai käynnistänyt järjestelmän uudelleen, nitropy on nyt käytettävissä.

Arch

Voit asentaa nitropyn ja kaikki muut tarvittavat riippuvuudet käyttämällä:

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

Jos olet jo asentanut Pythonin järjestelmääsi, voit yksinkertaisesti ajaa:

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

Kun olet kirjautunut ulos tai käynnistänyt järjestelmän uudelleen, nitropy on nyt käytettävissä.

Asennus muihin jakelu-/käyttöjärjestelmiin

Valmistelu

Python 3.9, 3.10 tai 3.11.

Python on jo asennettu useimpiin macOS- ja Linux-järjestelmiin tai sen voi ladata osoitteesta python.org. Katso lisätietoja Pythonin latausoppaasta.

pip

Voit asentaa pipin järjestelmän paketinhallinnan avulla tai python3 -m ensurepip. Katso lisätietoja pipin asennusoppaasta.

pipx

Ennen nitropyn asentamista sinun on asennettava ja konfiguroitava pipx:

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

Lisätietoja on osoitteessa pipx Installation Guide.

Muista

Linux-käyttäjille - tällä hetkellä väliaikainen riippuvuus (oscrypto) aiheuttaa ongelmia joissakin Linux-jakeluissa. Vastaava GitHub-ongelma dokumentoi tällä hetkellä tarvittavan ratkaisun:

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

Asennus

Nyt voit asentaa nitropyn pynitrokey-paketista:

pipx install pynitrokey

nitropy on nyt saatavilla polussasi:

nitropy --help

Päivitys

Voit päivittää paketin seuraavalla komennolla:

pipx upgrade pynitrokey

Vianmääritys

Jos kohtaat ongelmia, varmista, että käytät uusinta versiota vertaamalla nitropy version:n tulosta julkaisuluetteloon GitHubissa. Jos päivitys ei asenna uusinta versiota, sinulla saattaa olla jokin seuraavista ongelmista.

Väärä Python-versio

nitropy vaatii Python 3.9 tai 3.10. Jos oletusarvoinen Python-asennuksesi on vanhempi tai uudempi eikä sitä voi päivittää, sinun on lisäksi asennettava Python 3.9 ja määritettävä sen Python-ohjelman nimi, kun kutsut pipx:ää, esimerkiksi:

$ pipx install --python python3.9 pynitrokey

libusb-1.0.dylib ei löydy

Kun käytät nitropy-ohjelmaa macOS:ssä, saatat nähdä virheilmoituksen, joka kertoo puuttuvasta libusb-1.0.dylib-tiedostosta. Tämä voidaan korjata asentamalla libusb manuaalisesti, esimerkiksi homebrew:

$ brew install libusb

Käyttöä koskevat huomautukset

Kaikki alustat

Jos haluat käyttää nitropyä Nitrokey Pro- tai Nitrokey Storage -laitteen kanssa, sinun on myös asennettava libnitrokey.

Windows

Windows-tuki on vielä kokeellinen - käytä sitä varoen.

Sinun on ehkä suoritettava nitropy järjestelmänvalvojan oikeuksin voidaksesi muodostaa yhteyden laitteeseen.

Linux

Linux-järjestelmissä tarvitset myös Nitrokey udev-säännöt. Nämä toimitetaan libnitrokey mukana. Vaihtoehtoisesti voit asentaa ne manuaalisesti:

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

Katso udev-sääntöjen määrittäminen lisätietoja.

Usage of PIV features

Jotta voit käyttää nitropyn PIV-toimintoja (nitropy nk3 piv), sinun on asennettava myös pyscard -riippuvuus:

pipx install pynitrokey[pcsc]

Seuraavat vaiheet

Näistä oppaista löydät lisätietoja nitropian käytöstä: