Installing nitropy With pipx#

This guide explains how to install nitropy with pipx. pipx creates a virtual environment for nitropy. This means that nitropy and its dependencies don’t conflict with other packages installed on your system.


For Windows users: Windows support is still experimental – please use with caution. You can also use pre-compiled binaries or a MSI installer, see Installing nitropy on Windows.


Python 3.6 or newer#

Python is already installed on most macOS and Linux systems or can be downloaded from See the Downloading Python Guide for more information.


You can install pip with your system package manager or with python3 -m ensurepip. See the pip Installation Guide for more information.


Before installing nitropy, you have to install and configure pipx:

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

See the pipx Installation Guide for more information.


Now you can install nitropy from the pynitrokey package:

pipx install pynitrokey

nitropy is now available in your path:

nitropy --help

Usage Notes#

All Platforms#

If you want to use nitropy with a Nitrokey Pro or Nitrokey Storage device, you also have to install libnitrokey.


Windows support is still experimental – please use with caution.

You might have to run nitropy with administrator rights to be able to connect to a device.


On Linux systems, you also need the Nitrokey udev rules. These are shipped with libnitrokey. Alternatively, you can install them manually:

sudo mv 41-nitrokey.rules /etc/udev/rules.d/

See Setting up The udev Rules For nitropy for more information.

Next Steps#

You can find more information on using nitropy in these guides: