pipxでnitropyをインストールする¶

このガイドは、pipx を使って nitropy をインストールする方法を説明します。 pipx は nitropy のために仮想環境を作成します。これは、nitropyとその依存関係が、あなたのシステムにインストールされている他のパッケージと衝突しないことを意味します。

注釈

Windowsユーザーの方へ: Windowsのサポートはまだ実験的なものです -- 慎重に使用してください。プリコンパイルされたバイナリやMSIインストーラを使用することもできます。

Linuxへのインストール¶

Ubuntu、Debian¶

他のすべての必要な依存関係とともに、nitropy をインストールするには次のようにします：

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

ログアウトするかシステムを再起動すると、nitropyが利用できるようになります。

アーチ¶

他のすべての必要な依存関係とともに、nitropy をインストールするには次のようにします：

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

すでにPythonがインストールされている場合は、次のように実行するだけです：

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

ログアウトするかシステムを再起動すると、nitropyが利用できるようになります。

フェドラ¶

他のすべての必要な依存関係とともに、nitropy をインストールするには次のようにします：

$ sudo dnf install python pipx && pipx ensurepath && pipx install pynitrokey

すでにPythonがインストールされている場合は、次のように実行するだけです：

$ sudo dnf install pipx && pipx ensurepath && pipx install pynitrokey

After logging our or restarting your system, nitropy will now be available.

マゲイア¶

他のすべての必要な依存関係とともに、nitropy をインストールするには次のようにします：

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

すでにPythonがインストールされている場合は、次のように実行するだけです：

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

他のディストリビューション／オペレーティング・システムへの設置¶

準備¶

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はシステムのパッケージマネージャ、または``python3 -m ensurepip``でインストールすることができます。詳しくは pip インストールガイドを参照してください。

ピップス¶

nitropyをインストールする前に、pipx:をインストールし、設定する必要があります。

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

詳細については、`pipxインストールガイド<https://pipx.pypa.io/stable/>`__を参照してください。

インストール¶

これで、pynitrokeyパッケージからnitropyをインストールすることができます:

$ pipx install pynitrokey

nitropyがpath:で使用できるようになりました。

$ nitropy --help

アップグレード¶

以下のコマンドで、パッケージをアップグレードできます。

$ pipx upgrade pynitrokey

トラブルシューティング¶

問題が発生した場合は、nitropy version の出力と GitHub のリリースリスト <https://github.com/Nitrokey/pynitrokey/releases>`_ を比較して最新版を使用しているかどうか確認して下さい。アップグレードで最新版がインストールされない場合、以下のような問題が発生している可能性があります。

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 が見つかりません。¶

macOS で nitropy を実行すると、libusb-1.0.dylib ファイルがないことを示すエラーメッセージが表示されることがあります。これは、homebrew:.NET を使って手動で libusb をインストールすれば直ります。

$ brew install libusb

使用上の注意¶

すべてのプラットフォーム¶

Nitrokey Pro や Nitrokey Storage デバイスで nitropy を使用する場合は、libnitrokey もインストールしておく必要があります。

Windows¶

Windowsへの対応はまだ実験的なものであり、使用には注意が必要です。

デバイスに接続するために、管理者権限でnitropyを実行する必要がある場合があります。

Linux¶

Linux システムでは、Nitrokey の udev ルールも必要です。これらは libnitrokey と一緒に出荷されています。あるいは、手動でインストールすることもできます:

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

詳しくは 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]

次のステップ¶

nitropyの使用方法については、これらのガイドで詳しく説明しています。