Instalace nitropy pomocí pipx¶

Tento návod vysvětluje, jak nainstalovat nitropy pomocí pipx. pipx vytvoří virtuální prostředí pro nitropy. To znamená, že nitropy a jeho závislosti nebudou v konfliktu s jinými balíčky nainstalovanými v systému.

Poznámka

Pro uživatele systému Windows: Podpora systému Windows je stále experimentální - používejte ji prosím s opatrností. Můžete také použít předkompilované binární soubory nebo instalační program MSI, viz Instalace nitropy v systému Windows.

Instalace v systému Linux¶

Ubuntu, Debian¶

Nitropy můžete nainstalovat spolu se všemi dalšími požadovanými závislostmi pomocí:

$ sudo apt install pipx libpython3-dev libudev-dev && pipx ensurepath && pipx install pynitrokey

Po odhlášení nebo restartování systému bude nyní k dispozici aplikace nitropy.

Arch¶

Nitropy můžete nainstalovat spolu se všemi dalšími požadovanými závislostmi pomocí:

$ sudo pacman -S python python-pipx && pipx ensurepath && pipx install pynitrokey

Pokud již máte Python v systému nainstalován, můžete jednoduše spustit:

$ sudo pacman -S python-pipx && pipx ensurepath && pipx install pynitrokey

Po odhlášení nebo restartování systému bude nyní k dispozici aplikace nitropy.

Fedora¶

Nitropy můžete nainstalovat spolu se všemi dalšími požadovanými závislostmi pomocí:

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

Pokud již máte Python v systému nainstalován, můžete jednoduše spustit:

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

Po odhlášení nebo restartování systému bude nyní k dispozici aplikace nitropy.

Mageia¶

Nitropy můžete nainstalovat spolu se všemi dalšími požadovanými závislostmi pomocí:

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

Pokud již máte Python v systému nainstalován, můžete jednoduše spustit:

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

Instalace v jiných distribučních/provozních systémech¶

Příprava¶

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¶

Pip můžete nainstalovat pomocí správce systémových balíčků nebo pomocí python3 -m ensurepip. Další informace naleznete v příručce pro instalaci pip.

pipx¶

Před instalací nitropy musíte nainstalovat a nakonfigurovat pipx:

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

Další informace naleznete v instalační příručce pipx.

Instalace¶

Nyní můžete nainstalovat nitropy z balíčku pynitrokey:

$ pipx install pynitrokey

nitropy je nyní k dispozici ve vaší cestě:

$ nitropy --help

Upgrade¶

Balíček můžete aktualizovat pomocí následujícího příkazu:

$ pipx upgrade pynitrokey

Řešení problémů¶

Pokud narazíte na problémy, ujistěte se, že používáte nejnovější verzi, a to porovnáním výstupu nitropy version se seznamem release na GitHubu. Pokud se při aktualizaci nenainstaluje nejnovější verze, může se jednat o jeden z následujících problémů.

Špatná verze jazyka 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 nebyl nalezen¶

Při spuštění nitropy v systému macOS se může zobrazit chybová zpráva, že chybí soubor libusb-1.0.dylib. To lze opravit ruční instalací libusb, např. pomocí homebrew:

$ brew install libusb

Poznámky k použití¶

Všechny platformy¶

Pokud chcete nitropy používat se zařízením Nitrokey Pro nebo Nitrokey Storage, musíte také nainstalovat libnitrokey.

Windows¶

Podpora systému Windows je stále experimentální - používejte ji prosím s opatrností.

Abyste se mohli k zařízení připojit, bude možná nutné spustit nitropy s právy správce.

Linux¶

V systémech Linux potřebujete také pravidla Nitrokey udev. Ta jsou dodávána s libnitrokey. Případně je můžete nainstalovat ručně:

$ wget https://raw.githubusercontent.com/Nitrokey/nitrokey-udev-rules/refs/heads/main/41-nitrokey.rules
$ sudo mv 41-nitrokey.rules /etc/udev/rules.d/

Další informace naleznete v Nastavení pravidel udev.

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]

Další kroky¶

Další informace o používání nitropy najdete v těchto příručkách: