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

Preparação#

Python 3.9 ou mais recente#

Python já está instalado na maioria dos sistemas MacOS e Linux ou pode ser descarregado de python.org. Ver o Downloading Python Guide para mais informações.

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

Ver o guia de instalação pipx para mais informações.

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.

Versão Python demasiado antiga#

a nitropia requer Python 3.9 ou posterior. Se a sua instalação padrão Python for mais antiga do que isso e não puder ser actualizada, tem de instalar adicionalmente Python 3.9 e especificar o nome do seu executável Python ao chamar pipx, por exemplo:

$ pipx install --python python3.9 pynitrokey

Braço Não Suportado#

Actualmente, as versões recentes de nitropia não podem ser instaladas em plataformas Arm devido a um problema de dependência (GitHub issue). Como alternativa, pode usar uma instalação Python x86 num terminal Rosetta como descrito em `esta discussão <https://stackoverflow.com/questions/71691598/how-to-run-python-as-x86-with-rosetta2-on-arm-macos-machine>>x id=»387»></x>).

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/libnitrokey/master/data/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/

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

Próximos Passos#

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

  • …/…/…/nitrokey3/firmware-update