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 libpython3-dev libudev-dev && 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ä.

Fedora

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

$ sudo dnf install python pipx python3-devel libudev-devel && pipx ensurepath && pipx install pynitrokey

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

$ sudo dnf install pipx python3-devel libudev-devel && pipx ensurepath && pipx install pynitrokey

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

Mageia

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

$ sudo dnf install python python3-pip && pip install --user pipx && pipx ensurepath && pipx install pynitrokey

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

$ sudo dnf install python3-pip && pip install --user pipx && pipx ensurepath && pipx install pynitrokey

After logging our or restarting your system, nitropy will now be available.

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

Valmistelu

Python

Python is already installed on most macOS and Linux systems or can be downloaded from python.org. Currently the supported Python versions are 3.9, 3.10, 3.11, 3.12 and 3.13. See the Downloading Python Guide for more information.

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.

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

If your default Python installation is not in the supported versions list above, you need to specify an alternative to pipx. Install a supported version of Python and specify the name of its Python executable when calling pipx, for example:

$ 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

To be able to use the PIV functionality of nitropy (nitropy nk3 piv), you need to install the pyscard dependency too:

$ pipx install pynitrokey[pcsc]

Seuraavat vaiheet

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