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

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

注釈

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

準備#

Python 3.9 以降#

Python はほとんどの macOS と Linux システムに既にインストールされているか、python.org からダウンロードすることが可能です。詳しくは Downloading Python Guide を参照してください。

ピップ#

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

ピップス#

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

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

詳しくは、pipx インストールガイド をご覧ください。

インストール#

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

pipx install pynitrokey

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

nitropy --help

アップグレード#

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

pipx upgrade pynitrokey

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

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

Pythonのバージョンが古すぎる#

nitropyはPython3.9以降を必要とします。 もし、デフォルトでインストールされているPythonがそれよりも古く、アップデートできない場合は、追加でPython 3.9をインストールし、pipxを呼び出す際にそのPython実行ファイルの名前を指定する必要があります。

$ pipx install --python python3.9 pynitrokey

アーム非対応#

現在、最近の nitropy のバージョンは依存関係の問題により Arm プラットフォームにインストールできません (GitHub issue). 回避策として、this discussion にあるように、x86 Python インストールを Rosetta ターミナルで使用することができます)。

使用上の注意#

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

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

Windows#

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

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

Linux#

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

wget https://raw.githubusercontent.com/Nitrokey/libnitrokey/master/data/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/

詳しくは nitropy の udev ルールのセットアップ を参照してください。

次のステップ#

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

  • doc:../../../nitrokey3/firmware-update.