Instalação de nitropia Com pipx¶

Este guia explica como instalar a nitropia com pipx. pipx cria um ambiente virtual para a nitropia. Isto significa que a nitropia e as suas dependências não entram em conflito com outros pacotes instalados no seu sistema.

Nota

Para utilizadores de Windows: O suporte de Windows ainda é experimental – por favor use com cautela. Também pode utilizar binários pré-compilados ou um instalador MSI, ver :doc:`…/windows/installation”.

Installation on Linux¶

Fedora¶

Pode instalar o nitropia juntamente com todas as outras dependências necessárias utilizando:

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

Depois de terminar a sessão ou reiniciar o sistema, a nitropia estará agora disponível.

Arco¶

Pode instalar o nitropia juntamente com todas as outras dependências necessárias utilizando:

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

Se já tiver instalado o Python no seu sistema, pode simplesmente executar:

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

Depois de terminar a sessão ou reiniciar o sistema, a nitropia estará agora disponível.

Fedora¶

Pode instalar o nitropia juntamente com todas as outras dependências necessárias utilizando:

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

Se já tiver instalado o Python no seu sistema, pode simplesmente executar:

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

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

Mageia¶

Pode instalar o nitropia juntamente com todas as outras dependências necessárias utilizando:

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

Se já tiver instalado o Python no seu sistema, pode simplesmente executar:

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

Instalação noutros sistemas de distribuição/operacionais¶

Preparação¶

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¶

Pode instalar pip com o seu gestor de pacotes do sistema ou com python3 -m ensurepip`. Ver o guia de instalação de pip para mais informações.

pipx¶

Antes de instalar a nitropia, é necessário instalar e configurar o pipx:

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

See the pipx Installation Guide for more information.

Instalação¶

Agora pode instalar nitropia a partir do pacote pynitrokey:

$ pipx install pynitrokey

a nitropia está agora disponível no seu caminho:

$ nitropy --help

Actualização¶

Pode actualizar o pacote com o seguinte comando:

$ pipx upgrade pynitrokey

Resolução de problemas¶

Se encontrar problemas, certifique-se de que utiliza a versão mais recente comparando a saída de >>x id=»105»></x>>x id=»120»></x> com a release list no GitHub. Se uma actualização não instalar a versão mais recente, pode estar a deparar-se com um dos seguintes problemas.

Alteração do armazenamento do certificado pessoal do utilizador com <x id=»57»></x>`<x id=»59»></x><x id=»98»></x>`.¶

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 não encontrado¶

Ao executar o nitropia no macOS, poderá ver uma mensagem de erro indicando um ficheiro libusb-1.0.dylib em falta. Isso pode ser corrigido instalando manualmente o libusb, por exemplo, com homebrew:

$ brew install libusb

Notas de utilização¶

Todas as Plataformas¶

Se quiser usar nitropia com um dispositivo Nitrokey Pro ou Nitrokey Storage, também tem de instalar libnitrokey.

Windows¶

O suporte do Windows ainda é experimental – por favor use com cuidado.

Poderá ter de executar nitropia com direitos de administrador para se poder ligar a um dispositivo.

Linux¶

Nos sistemas Linux, também precisa das regras da Nitrokey udev. Estas são enviadas com libnitrokey. Em alternativa, pode instalá-las 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/

Ver …/linux/udev para mais informações.

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]

Próximos Passos¶

Pode encontrar mais informações sobre a utilização da nitropia nestes guias: