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#
Ubuntu, Debian#
You can install nitropy along with all other required dependencies by using:
sudo apt install pipx && pipx ensurepath && pipx install pynitrokey
After logging out or restarting your system, nitropy will now be available.
Arch#
You can install nitropy along with all other required dependencies by using:
sudo pacman -S python python-pipx && pipx ensurepath && pipx install pynitrokey
If you have already installed Python on your system, you can simply run:
sudo pacman -S python-pipx && pipx ensurepath && pipx install pynitrokey
After logging out or restarting your system, nitropy will now be available.
Installation on other distributions/operating systems#
Preparação#
Python 3.9, 3.10 or 3.11#
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
See the pipx Installation Guide for more information.
Nota
For Linux Users - currently a transient dependency (oscrypto
) is generating issues on some Linux distrubutions.
The respective GitHub issue documents the
currently needed workaround:
pipx inject --pip-args="--upgrade --force" pynitrokey "oscrypto @ git+https://github.com/wbond/oscrypto.git@1547f535001ba568b239b8797465536759c742a3"
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.
Wrong Python Version#
nitropy requires Python 3.9 or 3.10. If your default Python installation is older or newer than that and cannot be updated, you have to additionally install Python 3.9 and specify the name of its Python executable when calling pipx, for example:
$ pipx install --python python3.9 pynitrokey
Braço Não Suportado#
Currently, recent nitropy versions cannot be installed on Arm platforms due to a dependency issue (GitHub issue). As a workaround, you can use an x86 Python installation in a Rosetta terminal as described in this discussion).
libusb-1.0.dylib not found#
When running nitropy on macOS, you might see an error message indicating a missing libusb-1.0.dylib file. This can be fixed by manually installing libusb, e. g. with 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/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:
For Linux: Atualização do Firmware
For Mac: Atualização do Firmware
For Windows: Atualização do Firmware