Instalación de nitropy con pipx#
Esta guía explica cómo instalar nitropy con pipx. pipx crea un entorno virtual para nitropy. Esto significa que nitropy y sus dependencias no entran en conflicto con otros paquetes instalados en su sistema.
Nota
Para los usuarios de Windows: El soporte de Windows es todavía experimental - por favor, utilícelo con precaución. También puede utilizar binarios precompilados o un instalador MSI, véase Instalación de nitropy en Windows.
Instalación en Linux#
Ubuntu, Debian#
Puede instalar nitropy junto con el resto de dependencias necesarias mediante:
sudo apt install pipx && pipx ensurepath && pipx install pynitrokey
Tras cerrar la sesión o reiniciar el sistema, nitropy estará disponible.
Arch#
Puede instalar nitropy junto con el resto de dependencias necesarias mediante:
sudo pacman -S python python-pipx && pipx ensurepath && pipx install pynitrokey
Si ya ha instalado Python en su sistema, sólo tiene que ejecutar:
sudo pacman -S python-pipx && pipx ensurepath && pipx install pynitrokey
Tras cerrar la sesión o reiniciar el sistema, nitropy estará disponible.
Instalación en otras distribuciones/sistemas operativos#
Preparación#
Python 3.9, 3.10 o 3.11#
Python ya está instalado en la mayoría de los sistemas macOS y Linux o puede descargarse desde python.org. Consulte la Guía de descarga de Python para obtener más información.
pip#
Puede instalar pip con el gestor de paquetes de su sistema o con python3 -m ensurepip
. Consulte la Guía de instalación de pip para obtener más información.
pipx#
Antes de instalar nitropy, hay que instalar y configurar pipx:
python3 -m pip install --user pipx
python3 -m pipx ensurepath
Consulte la Guía de instalación de pipx para obtener más información.
Nota
Para usuarios de Linux - actualmente una dependencia transitoria (oscrypto
) está generando problemas en algunas distribuciones de Linux. El respectivo GitHub tema documenta la solución actualmente necesaria:
pipx inject --pip-args="--upgrade --force" pynitrokey "oscrypto @ git+https://github.com/wbond/oscrypto.git@1547f535001ba568b239b8797465536759c742a3"
Instalación#
Ahora puedes instalar nitropy desde el paquete pynitrokey:
pipx install pynitrokey
nitropy está ahora disponible en su ruta:
nitropy --help
Actualizar#
Puede actualizar el paquete con el siguiente comando:
pipx upgrade pynitrokey
Solución de problemas#
Si tiene problemas, asegúrese de que utiliza la última versión comparando la salida de nitropy version
con la lista de versiones ` en GitHub. Si una actualización no instala la última versión, es posible que te encuentres con uno de los siguientes problemas.
Versión incorrecta de Python#
nitropy requiere Python 3.9 o 3.10. Si su instalación por defecto de Python es más antigua o más reciente que eso y no se puede actualizar, tiene que instalar adicionalmente Python 3.9 y especificar el nombre de su ejecutable Python al llamar a pipx, por ejemplo:
$ pipx install --python python3.9 pynitrokey
Brazo no soportado#
Actualmente, las versiones recientes de nitropy no pueden instalarse en plataformas Arm debido a un problema de dependencia (GitHub issue). Como solución alternativa, puede utilizar una instalación de Python x86 en un terminal Rosetta como se describe en esta discusión).
libusb-1.0.dylib no encontrado#
Al ejecutar nitropy en macOS, es posible que aparezca un mensaje de error indicando que falta el archivo libusb-1.0.dylib. Esto puede solucionarse instalando manualmente libusb, por ejemplo, con homebrew:
$ brew install libusb
Notas de uso#
Todas las plataformas#
Si quieres usar nitropy con un dispositivo Nitrokey Pro o Nitrokey Storage, también tienes que instalar libnitrokey.
Windows#
La compatibilidad con Windows es todavía experimental: utilícela con precaución.
Es posible que tengas que ejecutar nitropy con derechos de administrador para poder conectarte a un dispositivo.
Linux#
En los sistemas Linux, también necesita las reglas udev de Nitrokey. Se suministran con libnitrokey. Alternativamente, puede instalarlos manualmente:
wget https://raw.githubusercontent.com/Nitrokey/libnitrokey/master/data/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/
Consulte Configuración de las reglas udev para más información.
Próximos pasos#
Puedes encontrar más información sobre el uso de nitropía en estas guías:
Para Linux: Actualización del firmware.
Para Mac: Actualización del firmware.
Para Windows: Actualización del firmware.