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 libpython3-dev libudev-dev && 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.

Fedora¶

Puede instalar nitropy junto con el resto de dependencias necesarias mediante:

$ sudo dnf install python pipx python3-devel libudev-devel && pipx ensurepath && pipx install pynitrokey

Si ya ha instalado Python en su sistema, sólo tiene que ejecutar:

$ sudo dnf install pipx python3-devel libudev-devel && pipx ensurepath && pipx install pynitrokey

Tras cerrar la sesión o reiniciar el sistema, nitropy estará disponible.

Mageia¶

Puede instalar nitropy junto con el resto de dependencias necesarias mediante:

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

Si ya ha instalado Python en su sistema, sólo tiene que ejecutar:

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

Instalación en otras distribuciones/sistemas operativos¶

Preparación¶

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¶

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.

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¶

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 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/nitrokey-udev-rules/refs/heads/main/41-nitrokey.rules
$ sudo mv 41-nitrokey.rules /etc/udev/rules.d/

Consulte Configuración de las reglas udev para más información.

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 pasos¶

Puedes encontrar más información sobre el uso de nitropía en estas guías: