From 3e1c87b0847def73cd4902bbc6f7aa3bef753a18 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sosth=C3=A8ne=20Gu=C3=A9don?= Date: Thu, 24 Oct 2024 17:23:18 +0200 Subject: [PATCH] Add troubleshooting info for installing missing pyscard dependency --- nitrokey3/troubleshooting.rst.inc | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/nitrokey3/troubleshooting.rst.inc b/nitrokey3/troubleshooting.rst.inc index 519b6a8c56..673abc533c 100644 --- a/nitrokey3/troubleshooting.rst.inc +++ b/nitrokey3/troubleshooting.rst.inc @@ -109,3 +109,21 @@ Currently the web updater doesn't support the Nitrokey 3. However you can get th .. _nfc.fail: https://nfc.fail/ + +Piv Troubleshooting +^^^^^^^^^^^^^^^^^^^ + +Pyscard is not available +------------------------ + +If pyscard is not available to nitropy, you might get the following error trying to use the PIV functionality: + + This command requires the pyscard library that is not available on your system. Please consult https://docs.nitrokey.com/nitrokey3/linux/troubleshooting#pyscard-is-not-available for more information + +To fix this error, please install nitropy with the `pcsc` extra dependencies: + + pip install pynitrokey[pcsc] + pipx install pynitrokey[pcsc] + +If you install pynitrokey through another distrubition channel, please install all optional dependencies for this channel. +