Installazione di nitropy con pipx¶

Questa guida spiega come installare nitropy con pipx. pipx crea un ambiente virtuale per nitropy. Ciò significa che nitropy e le sue dipendenze non entrano in conflitto con altri pacchetti installati sul sistema.

Nota

Per gli utenti di Windows: Il supporto di Windows è ancora sperimentale: usare con cautela. È anche possibile utilizzare binari precompilati o un programma di installazione MSI, vedere Installazione di nitropy su Windows.

Installazione su Linux¶

Ubuntu, Debian¶

È possibile installare nitropy insieme a tutte le altre dipendenze necessarie utilizzando:

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

Dopo il logout o il riavvio del sistema, nitropy sarà ora disponibile.

Arco¶

È possibile installare nitropy insieme a tutte le altre dipendenze necessarie utilizzando:

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

Se avete già installato Python sul vostro sistema, potete semplicemente eseguire:

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

Dopo il logout o il riavvio del sistema, nitropy sarà ora disponibile.

Fedora¶

È possibile installare nitropy insieme a tutte le altre dipendenze necessarie utilizzando:

$ sudo dnf install python pipx && pipx ensurepath && pipx install pynitrokey

Se avete già installato Python sul vostro sistema, potete semplicemente eseguire:

$ sudo dnf install pipx && pipx ensurepath && pipx install pynitrokey

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

Mageia¶

È possibile installare nitropy insieme a tutte le altre dipendenze necessarie utilizzando:

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

Se avete già installato Python sul vostro sistema, potete semplicemente eseguire:

$ 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.

Installazione su altre distribuzioni/sistemi operativi¶

Preparazione¶

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¶

È possibile installare pip con il gestore di pacchetti di sistema o con python3 -m ensurepip. Per ulteriori informazioni, consultare la Guida all’installazione di pip.

pipx¶

Prima di installare nitropy, è necessario installare e configurare pipx:

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

Per ulteriori informazioni, consultare la Guida all’installazione di pipx.

Installazione¶

Ora è possibile installare nitropy dal pacchetto pynitrokey:

$ pipx install pynitrokey

nitropy è ora disponibile nel percorso:

$ nitropy --help

Aggiornamento¶

È possibile aggiornare il pacchetto con il seguente comando:

$ pipx upgrade pynitrokey

Risoluzione dei problemi¶

In caso di problemi, assicurarsi di utilizzare la versione più recente confrontando l’output di nitropy version con l’elenco delle release ` <https://github.com/Nitrokey/pynitrokey/releases>`_ su GitHub. Se un aggiornamento non installa l’ultima versione, è possibile che si sia verificato uno dei seguenti problemi.

Versione di Python sbagliata¶

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 non trovato¶

Quando si esegue nitropy su macOS, è possibile che venga visualizzato un messaggio di errore che indica la mancanza del file libusb-1.0.dylib. Questo problema può essere risolto installando manualmente libusb, ad esempio con homebrew:

$ brew install libusb

Note d’uso¶

Tutte le piattaforme¶

Se si desidera utilizzare nitropy con un dispositivo Nitrokey Pro o Nitrokey Storage, è necessario installare anche libnitrokey.

Windows¶

Il supporto per Windows è ancora sperimentale: usare con cautela.

Potrebbe essere necessario eseguire nitropy con i diritti di amministratore per potersi collegare a un dispositivo.

Linux¶

Sui sistemi Linux sono necessarie anche le regole Nitrokey udev. Queste vengono fornite con libnitrokey. In alternativa, è possibile installarle manualmente:

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

Per ulteriori informazioni, vedere Impostazione delle regole udev.

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]

I prossimi passi¶

Per ulteriori informazioni sull’uso di nitropy, consultare queste guide: