From b0f6826519073b311d787b3653b419505c191481 Mon Sep 17 00:00:00 2001 From: blu-nitro Date: Mon, 1 Jun 2026 19:41:15 +0200 Subject: [PATCH 01/10] nk app 1: add download links for nitrokey app 1 (#570) --- source/components/software/index.rst | 1 + source/components/software/nk-app1/index.rst | 164 +++++++++++++++++++ 2 files changed, 165 insertions(+) create mode 100644 source/components/software/nk-app1/index.rst diff --git a/source/components/software/index.rst b/source/components/software/index.rst index 86736050ca..2022eef761 100644 --- a/source/components/software/index.rst +++ b/source/components/software/index.rst @@ -6,5 +6,6 @@ Software :titlesonly: nk-app2/index + nk-app1/index nitropy/index nitrokey-sdk-py/index diff --git a/source/components/software/nk-app1/index.rst b/source/components/software/nk-app1/index.rst new file mode 100644 index 0000000000..6b1f835d13 --- /dev/null +++ b/source/components/software/nk-app1/index.rst @@ -0,0 +1,164 @@ +Nitrokey App 1 +============== + +The Nitrokey App 1 is a graphical application designed to manage Nitrokey Pro and Nitrokey Storage devices. + +.. note:: + + This application is compatible only with Nitrokey Pro and Nitrokey Storage devices. For Nitrokey 3 devices, please use `Nitrokey App 2 <../nk-app2>`__. + +.. toctree:: + :maxdepth: 1 + :glob: + :hidden: + + * + +Installation +------------ + +The latest Nitrokey App is version 1.4.2 (`Release notes `__, `PGP signatures and older versions `__). + +Released binaries are signed by PGP key: +`868184069239FF65DE0BCD7DD9BAE35991DE5B22 `__ `szczepan@nitrokey.com `__. + +Alpine Linux +************ + +Nitrokey App isn't an official package to Alpine Linux but this `inofficial package `__ can be used. + +FreeBSD +******* + +Install by executing: + +.. code-block:: bash + + $ pkg install nitrokey-app + +Guix +**** + +Further information `here `__. + +Windows +******* + +Download .exe file from `here `__. + +macOS +***** + +**Single-file download** + +Download latest Nitrokey App (DMG file) `here `__. +**Note:** The Nitrokey App was not notarized by Apple yet, which is required by macOS 10.15. See this `forum post `__ for more information. + +**Homebrew** + +Users of `Homebrew `__ can install this `cask `__ to install the Nitrokey App via Homebrew. + +.. code-block:: bash + + $ brew tap homebrew/cask-drivers + $ brew install --cask nitrokey + +Fedora +****** + +Nitrokey App `is part `__ of Fedora's package repositories. Install it by executing: + +.. code-block:: bash + + $ sudo dnf install nitrokey-app + +Arch Linux +********** + +The Nitrokey App is included in the official extra repo. You can install the App by executing: + +.. code-block:: bash + + $ pacman -S nitrokey-app + +SUSE +**** + +Nitrokey App `is part `__ of SUSE's package repository. You can just install it `like every other software `__. + +NixOS +***** + +Nitrokey App `is part `__ of NixOS's package repository. + +Gentoo +****** + +Nitrokey App `is part `__ of Gentoo's package repositories. + +AppImage +******** + +AppImage provide everything that is needed to get executed. It works like a .exe on Windows and does not need to be installed. +See `here `__ for our latest Nitrokey-App.AppImage file. After downloading the file, you need to make the file executable. +You can do this by right-clicking on the file and choosing "Properties". Look for the option to make the file executable there. + +Flatpak +******* + +Execute the following commands: + +.. code-block:: bash + + $ flatpak install flathub com.nitrokey.nitrokey-app + $ flatpak run com.nitrokey.nitrokey-app + +For more information visit `Flathub `__. + +Snap +**** + +.. note:: + + There is a problem with the current Snap package. Please make sure that scdaemon is installed by typing + + .. code-block:: bash + + $ apt-get update && apt-get install scdaemon + + in a terminal and follow the instruction below. + +The latest Nitrokey App is available as Snap package which is available for many Linux distributions and which ensures that you always have the latest version installed. +Snapd is already installed on Ubuntu, for distros like Arch, Debian, Fedora, or Gentoo you need to `install snapd `__ first. As soon as you have Snap installed you can open a terminal and type + +.. code-block:: bash + + $ sudo snap install nitrokey-app --devmode + +to install Nitrokey App. You now can use it as usual, e.g. by pressing Alt + F2 and entering "nitrokey-app". + +**Troubleshooting** +In case you get the error "failed to create user data directory. errmsg: Permission denied" during starting the Nitrokey App, it may is because your home directory is encrypted. In this case, apply one of these fixes `[1] `__ `[2] `__. + +Debian +****** + +For Debian 9 and newer, the Nitrokey App is included in the Debian repository. You can just install it via Software Center or by typing the following in a terminal: + +.. code-block:: bash + + $ sudo apt update + $ sudo apt install nitrokey-app + +Unfortunately, the App versions in the official Debian repositories are often not up-to-date. + +Slackware +********* + +Available at `Slackbuilds `__. + +Source +****** + +You can download and compile the source code from `here `__. In this case you may need to install `these UDEV rules `__ manually. + From 7034a8e213c4c9b9ab25ced9a2b5e3ca0c52c777 Mon Sep 17 00:00:00 2001 From: ABuljko Date: Tue, 30 Jun 2026 20:13:26 +0200 Subject: [PATCH 02/10] Ubuntu added --- source/components/software/nk-app1/index.rst | 35 +++++++++++++++++--- 1 file changed, 30 insertions(+), 5 deletions(-) diff --git a/source/components/software/nk-app1/index.rst b/source/components/software/nk-app1/index.rst index 6b1f835d13..515a50431e 100644 --- a/source/components/software/nk-app1/index.rst +++ b/source/components/software/nk-app1/index.rst @@ -72,6 +72,11 @@ Nitrokey App `is part `__ of SUSE's package repository. You can just install it `like every other software `__. + Arch Linux ********** @@ -81,11 +86,6 @@ The Nitrokey App is included in the official extra repo. You can install the App $ pacman -S nitrokey-app -SUSE -**** - -Nitrokey App `is part `__ of SUSE's package repository. You can just install it `like every other software `__. - NixOS ***** @@ -152,6 +152,31 @@ For Debian 9 and newer, the Nitrokey App is included in the Debian repository. Y Unfortunately, the App versions in the official Debian repositories are often not up-to-date. +Ubuntu +****** + +The Nitrokey App is included in Ubuntu's repositories since Ubuntu 18.04 (codename 'bionic') on. You can just install it via Software Center or by typing the following in a terminal: + +.. code-block:: bash + + $ sudo apt update + $ sudo apt install nitrokey-app + +Unfortunately, the App versions in the official Ubuntu repositories are often not up-to-date. + +**More recent App versions** + +To get the most recent Nitrokey App you can add a separate repository which is maintained by Nitrokey. + +Please execute the following in a terminal to add the repository and install the Nitrokey App: + +.. code-block:: bash + + $ sudo add-apt-repository ppa:nitrokey/nitrokey + $ sudo apt install nitrokey-app + +**Alternatively**, you can use the snap package. Please see the `Snap`_ section for more information. + Slackware ********* From e0e57f023108da31b272f1f77f2ca7a34c963700 Mon Sep 17 00:00:00 2001 From: ABuljko Date: Tue, 30 Jun 2026 21:21:11 +0200 Subject: [PATCH 03/10] Sorted and removed redundancies --- source/components/software/nk-app1/index.rst | 131 +++++++++---------- 1 file changed, 62 insertions(+), 69 deletions(-) diff --git a/source/components/software/nk-app1/index.rst b/source/components/software/nk-app1/index.rst index 515a50431e..3aba2a6995 100644 --- a/source/components/software/nk-app1/index.rst +++ b/source/components/software/nk-app1/index.rst @@ -27,105 +27,108 @@ Alpine Linux Nitrokey App isn't an official package to Alpine Linux but this `inofficial package `__ can be used. -FreeBSD -******* - -Install by executing: - -.. code-block:: bash - - $ pkg install nitrokey-app - -Guix -**** - -Further information `here `__. +AppImage +******** -Windows -******* +AppImage provide everything that is needed to get executed. It works like a .exe on Windows and does not need to be installed. +See `here `__ for our latest Nitrokey-App.AppImage file. After downloading the file, you need to make the file executable. +You can do this by right-clicking on the file and choosing "Properties". Look for the option to make the file executable there. -Download .exe file from `here `__. +Arch Linux +********** -macOS -***** +The Nitrokey App is included in the official extra repo. -**Single-file download** +.. code-block:: bash -Download latest Nitrokey App (DMG file) `here `__. -**Note:** The Nitrokey App was not notarized by Apple yet, which is required by macOS 10.15. See this `forum post `__ for more information. + $ pacman -S nitrokey-app -**Homebrew** +Debian +****** -Users of `Homebrew `__ can install this `cask `__ to install the Nitrokey App via Homebrew. +For Debian 9 and newer, the Nitrokey App is included in the Debian repository. .. code-block:: bash - $ brew tap homebrew/cask-drivers - $ brew install --cask nitrokey + $ sudo apt update + $ sudo apt install nitrokey-app + +Unfortunately, the App versions in the official Debian repositories are often not up-to-date. Fedora ****** -Nitrokey App `is part `__ of Fedora's package repositories. Install it by executing: +Nitrokey App `is part `__ of Fedora's package repositories. .. code-block:: bash $ sudo dnf install nitrokey-app -SUSE -**** - -Nitrokey App `is part `__ of SUSE's package repository. You can just install it `like every other software `__. +Flatpak +******* -Arch Linux -********** +.. code-block:: bash -The Nitrokey App is included in the official extra repo. You can install the App by executing: + $ flatpak install flathub com.nitrokey.nitrokey-app + $ flatpak run com.nitrokey.nitrokey-app -.. code-block:: bash +For more information visit `Flathub `__. - $ pacman -S nitrokey-app +FreeBSD +******* -NixOS -***** +.. code-block:: bash -Nitrokey App `is part `__ of NixOS's package repository. + $ pkg install nitrokey-app Gentoo ****** Nitrokey App `is part `__ of Gentoo's package repositories. -AppImage -******** +Guix +**** -AppImage provide everything that is needed to get executed. It works like a .exe on Windows and does not need to be installed. -See `here `__ for our latest Nitrokey-App.AppImage file. After downloading the file, you need to make the file executable. -You can do this by right-clicking on the file and choosing "Properties". Look for the option to make the file executable there. +Further information `here `__. -Flatpak -******* +macOS +***** -Execute the following commands: +**Single-file download** + +Download latest Nitrokey App (DMG file) `here `__. +**Note:** The Nitrokey App was not notarized by Apple yet, which is required by macOS 10.15. See this `forum post `__ for more information. + +**Homebrew** + +Users of `Homebrew `__ can install this `cask `__ to install the Nitrokey App via Homebrew. .. code-block:: bash - $ flatpak install flathub com.nitrokey.nitrokey-app - $ flatpak run com.nitrokey.nitrokey-app + $ brew tap homebrew/cask-drivers + $ brew install --cask nitrokey -For more information visit `Flathub `__. +NixOS +***** + +Nitrokey App `is part `__ of NixOS's package repository. + +Slackware +********* + +Available at `Slackbuilds `__. Snap **** .. note:: - There is a problem with the current Snap package. Please make sure that scdaemon is installed by typing - + There is a problem with the current Snap package. Please make sure that scdaemon is installed by typing + .. code-block:: bash $ apt-get update && apt-get install scdaemon - + in a terminal and follow the instruction below. The latest Nitrokey App is available as Snap package which is available for many Linux distributions and which ensures that you always have the latest version installed. @@ -140,22 +143,15 @@ to install Nitrokey App. You now can use it as usual, e.g. by pressing Alt + F2 **Troubleshooting** In case you get the error "failed to create user data directory. errmsg: Permission denied" during starting the Nitrokey App, it may is because your home directory is encrypted. In this case, apply one of these fixes `[1] `__ `[2] `__. -Debian -****** - -For Debian 9 and newer, the Nitrokey App is included in the Debian repository. You can just install it via Software Center or by typing the following in a terminal: - -.. code-block:: bash - - $ sudo apt update - $ sudo apt install nitrokey-app +SUSE +**** -Unfortunately, the App versions in the official Debian repositories are often not up-to-date. +Nitrokey App `is part `__ of SUSE's package repository. You can just install it `like every other software `__. Ubuntu ****** -The Nitrokey App is included in Ubuntu's repositories since Ubuntu 18.04 (codename 'bionic') on. You can just install it via Software Center or by typing the following in a terminal: +The Nitrokey App is included in Ubuntu's repositories since Ubuntu 18.04 (codename 'bionic') on. .. code-block:: bash @@ -168,8 +164,6 @@ Unfortunately, the App versions in the official Ubuntu repositories are often no To get the most recent Nitrokey App you can add a separate repository which is maintained by Nitrokey. -Please execute the following in a terminal to add the repository and install the Nitrokey App: - .. code-block:: bash $ sudo add-apt-repository ppa:nitrokey/nitrokey @@ -177,13 +171,12 @@ Please execute the following in a terminal to add the repository and install the **Alternatively**, you can use the snap package. Please see the `Snap`_ section for more information. -Slackware -********* +Windows +******* -Available at `Slackbuilds `__. +Download .exe file from `here `__. Source ****** You can download and compile the source code from `here `__. In this case you may need to install `these UDEV rules `__ manually. - From 9f061655f9d4569ac25304e82d16ffde5031c063 Mon Sep 17 00:00:00 2001 From: abuljko Date: Thu, 2 Jul 2026 11:38:27 +0200 Subject: [PATCH 04/10] Suggestios implemented and design changed --- source/components/software/nk-app1/index.rst | 172 ++++++++----------- 1 file changed, 75 insertions(+), 97 deletions(-) diff --git a/source/components/software/nk-app1/index.rst b/source/components/software/nk-app1/index.rst index 3aba2a6995..18596008d0 100644 --- a/source/components/software/nk-app1/index.rst +++ b/source/components/software/nk-app1/index.rst @@ -22,161 +22,139 @@ The latest Nitrokey App is version 1.4.2 (`Release notes `__ `szczepan@nitrokey.com `__. -Alpine Linux -************ +Linux Distributions +******************* -Nitrokey App isn't an official package to Alpine Linux but this `inofficial package `__ can be used. +.. dropdown:: Alpine Linux -AppImage -******** + Nitrokey App isn't an official package to Alpine Linux but this `inofficial package `__ can be used. -AppImage provide everything that is needed to get executed. It works like a .exe on Windows and does not need to be installed. -See `here `__ for our latest Nitrokey-App.AppImage file. After downloading the file, you need to make the file executable. -You can do this by right-clicking on the file and choosing "Properties". Look for the option to make the file executable there. +.. dropdown:: Arch Linux -Arch Linux -********** + The Nitrokey App is included in the official extra repo. -The Nitrokey App is included in the official extra repo. - -.. code-block:: bash - - $ pacman -S nitrokey-app - -Debian -****** - -For Debian 9 and newer, the Nitrokey App is included in the Debian repository. + .. code-block:: bash -.. code-block:: bash + $ pacman -S nitrokey-app - $ sudo apt update - $ sudo apt install nitrokey-app +.. dropdown:: Debian -Unfortunately, the App versions in the official Debian repositories are often not up-to-date. + For Debian 9 and newer, the Nitrokey App is included in the Debian repository. -Fedora -****** + .. code-block:: bash -Nitrokey App `is part `__ of Fedora's package repositories. + $ sudo apt update + $ sudo apt install nitrokey-app -.. code-block:: bash + Unfortunately, the App versions in the official Debian repositories are often not up-to-date. - $ sudo dnf install nitrokey-app +.. dropdown:: Fedora -Flatpak -******* + Nitrokey App `is part `__ of Fedora's package repositories. -.. code-block:: bash + .. code-block:: bash - $ flatpak install flathub com.nitrokey.nitrokey-app - $ flatpak run com.nitrokey.nitrokey-app + $ sudo dnf install nitrokey-app -For more information visit `Flathub `__. +.. dropdown:: Guix -FreeBSD -******* + Further information `here `__. -.. code-block:: bash +.. dropdown:: NixOS - $ pkg install nitrokey-app + Nitrokey App `is part `__ of NixOS's package repository. -Gentoo -****** +.. dropdown:: Slackware -Nitrokey App `is part `__ of Gentoo's package repositories. + Available at `Slackbuilds `__. -Guix -**** +.. dropdown:: SUSE -Further information `here `__. + Nitrokey App `is part `__ of SUSE's package repository. You can just install it `like every other software `__. -macOS -***** +.. dropdown:: Ubuntu -**Single-file download** + The Nitrokey App is included in Ubuntu's repositories since Ubuntu 18.04 (codename 'bionic') on. -Download latest Nitrokey App (DMG file) `here `__. -**Note:** The Nitrokey App was not notarized by Apple yet, which is required by macOS 10.15. See this `forum post `__ for more information. + .. code-block:: bash -**Homebrew** + $ sudo apt update + $ sudo apt install nitrokey-app -Users of `Homebrew `__ can install this `cask `__ to install the Nitrokey App via Homebrew. + Unfortunately, the App versions in the official Ubuntu repositories are often not up-to-date. -.. code-block:: bash + **More recent App versions** - $ brew tap homebrew/cask-drivers - $ brew install --cask nitrokey + To get the most recent Nitrokey App you can add a separate repository which is maintained by Nitrokey. -NixOS -***** + .. code-block:: bash -Nitrokey App `is part `__ of NixOS's package repository. + $ sudo add-apt-repository ppa:nitrokey/nitrokey + $ sudo apt install nitrokey-app -Slackware -********* + **Alternatively**, you can use the snap package. Please see the :ref:`Snap ` entry under `Cross-Platform Packages`_ for more information. -Available at `Slackbuilds `__. +Non-Linux Systems +***************** -Snap -**** +.. dropdown:: FreeBSD -.. note:: + .. code-block:: bash - There is a problem with the current Snap package. Please make sure that scdaemon is installed by typing + $ pkg install nitrokey-app - .. code-block:: bash +.. dropdown:: macOS - $ apt-get update && apt-get install scdaemon + Download latest Nitrokey App (DMG file) `here `__. + **Note:** The Nitrokey App was not notarized by Apple yet, which is required by macOS 10.15. See this `forum post `__ for more information. - in a terminal and follow the instruction below. +.. dropdown:: Windows -The latest Nitrokey App is available as Snap package which is available for many Linux distributions and which ensures that you always have the latest version installed. -Snapd is already installed on Ubuntu, for distros like Arch, Debian, Fedora, or Gentoo you need to `install snapd `__ first. As soon as you have Snap installed you can open a terminal and type + Download .exe file from `here `__. -.. code-block:: bash +Cross-Platform Packages +*********************** - $ sudo snap install nitrokey-app --devmode +.. dropdown:: AppImage -to install Nitrokey App. You now can use it as usual, e.g. by pressing Alt + F2 and entering "nitrokey-app". + AppImage provide everything that is needed to get executed. It works like a .exe on Windows and does not need to be installed. + See `here `__ for our latest Nitrokey-App.AppImage file. After downloading the file, you need to make the file executable. + You can do this by right-clicking on the file and choosing "Properties". Look for the option to make the file executable there. -**Troubleshooting** -In case you get the error "failed to create user data directory. errmsg: Permission denied" during starting the Nitrokey App, it may is because your home directory is encrypted. In this case, apply one of these fixes `[1] `__ `[2] `__. +.. dropdown:: Flatpak -SUSE -**** + .. code-block:: bash -Nitrokey App `is part `__ of SUSE's package repository. You can just install it `like every other software `__. + $ flatpak install flathub com.nitrokey.nitrokey-app + $ flatpak run com.nitrokey.nitrokey-app -Ubuntu -****** + For more information visit `Flathub `__. -The Nitrokey App is included in Ubuntu's repositories since Ubuntu 18.04 (codename 'bionic') on. +.. dropdown:: Snap + :name: nk-app1-snap -.. code-block:: bash + .. note:: - $ sudo apt update - $ sudo apt install nitrokey-app + There is a problem with the current Snap package. Please make sure that scdaemon is installed by typing -Unfortunately, the App versions in the official Ubuntu repositories are often not up-to-date. + .. code-block:: bash -**More recent App versions** + $ apt-get update && apt-get install scdaemon -To get the most recent Nitrokey App you can add a separate repository which is maintained by Nitrokey. + in a terminal and follow the instruction below. -.. code-block:: bash + The latest Nitrokey App is available as Snap package which is available for many Linux distributions and which ensures that you always have the latest version installed. + Snapd is already installed on Ubuntu, for distros like Arch, Debian, Fedora, or Gentoo you need to `install snapd `__ first. As soon as you have Snap installed you can open a terminal and type - $ sudo add-apt-repository ppa:nitrokey/nitrokey - $ sudo apt install nitrokey-app + .. code-block:: bash -**Alternatively**, you can use the snap package. Please see the `Snap`_ section for more information. + $ sudo snap install nitrokey-app --devmode -Windows -******* + to install Nitrokey App. You now can use it as usual, e.g. by pressing Alt + F2 and entering "nitrokey-app". -Download .exe file from `here `__. + **Troubleshooting** + In case you get the error "failed to create user data directory. errmsg: Permission denied" during starting the Nitrokey App, it may is because your home directory is encrypted. In this case, apply one of these fixes `[1] `__ `[2] `__. -Source -****** +.. dropdown:: Source -You can download and compile the source code from `here `__. In this case you may need to install `these UDEV rules `__ manually. + You can download and compile the source code from `here `__. In this case you may need to install `these UDEV rules `__ manually. From 37b064d83b113b2d881cca5a2f494d8f9f9fb4e3 Mon Sep 17 00:00:00 2001 From: abuljko Date: Thu, 2 Jul 2026 11:51:26 +0200 Subject: [PATCH 05/10] CI failure fix --- rstcheck.toml | 1 + 1 file changed, 1 insertion(+) diff --git a/rstcheck.toml b/rstcheck.toml index 488aa0069a..a195225334 100644 --- a/rstcheck.toml +++ b/rstcheck.toml @@ -1,6 +1,7 @@ [tool.rstcheck] ignore_directives = [ "card", + "dropdown", "tabs", "faq", "product-table", From cb79331b4700f70ea73fcb1c73910db6cf8e3cd2 Mon Sep 17 00:00:00 2001 From: abuljko Date: Thu, 2 Jul 2026 15:08:51 +0200 Subject: [PATCH 06/10] Changes implemented --- source/components/software/nk-app1/index.rst | 61 ++++++++++---------- 1 file changed, 31 insertions(+), 30 deletions(-) diff --git a/source/components/software/nk-app1/index.rst b/source/components/software/nk-app1/index.rst index 18596008d0..a03ab5249a 100644 --- a/source/components/software/nk-app1/index.rst +++ b/source/components/software/nk-app1/index.rst @@ -1,11 +1,7 @@ Nitrokey App 1 ============== -The Nitrokey App 1 is a graphical application designed to manage Nitrokey Pro and Nitrokey Storage devices. - -.. note:: - - This application is compatible only with Nitrokey Pro and Nitrokey Storage devices. For Nitrokey 3 devices, please use `Nitrokey App 2 <../nk-app2>`__. +The Nitrokey App 1 is a graphical application designed to manage Nitrokey Pro and Nitrokey Storage devices. For Nitrokey 3 devices, please use `Nitrokey App 2 <../nk-app2>`__. .. toctree:: :maxdepth: 1 @@ -22,8 +18,8 @@ The latest Nitrokey App is version 1.4.2 (`Release notes `__ `szczepan@nitrokey.com `__. -Linux Distributions -******************* +Linux +***** .. dropdown:: Alpine Linux @@ -92,28 +88,7 @@ Linux Distributions $ sudo add-apt-repository ppa:nitrokey/nitrokey $ sudo apt install nitrokey-app - **Alternatively**, you can use the snap package. Please see the :ref:`Snap ` entry under `Cross-Platform Packages`_ for more information. - -Non-Linux Systems -***************** - -.. dropdown:: FreeBSD - - .. code-block:: bash - - $ pkg install nitrokey-app - -.. dropdown:: macOS - - Download latest Nitrokey App (DMG file) `here `__. - **Note:** The Nitrokey App was not notarized by Apple yet, which is required by macOS 10.15. See this `forum post `__ for more information. - -.. dropdown:: Windows - - Download .exe file from `here `__. - -Cross-Platform Packages -*********************** + **Alternatively**, you can use the snap package. Please see the **Snap** entry for more information. .. dropdown:: AppImage @@ -131,7 +106,6 @@ Cross-Platform Packages For more information visit `Flathub `__. .. dropdown:: Snap - :name: nk-app1-snap .. note:: @@ -155,6 +129,33 @@ Cross-Platform Packages **Troubleshooting** In case you get the error "failed to create user data directory. errmsg: Permission denied" during starting the Nitrokey App, it may is because your home directory is encrypted. In this case, apply one of these fixes `[1] `__ `[2] `__. +Windows +******* + +.. dropdown:: Windows + + Download .exe file from `here `__. + +macOS +***** + +.. dropdown:: macOS + + Download latest Nitrokey App (DMG file) `here `__. + **Note:** The Nitrokey App was not notarized by Apple yet, which is required by macOS 10.15. See this `forum post `__ for more information. + +FreeBSD +******* + +.. dropdown:: FreeBSD + + .. code-block:: bash + + $ pkg install nitrokey-app + +Source +****** + .. dropdown:: Source You can download and compile the source code from `here `__. In this case you may need to install `these UDEV rules `__ manually. From a7baf78c3c4f54d3ca0338d18dd7cf5387415c0a Mon Sep 17 00:00:00 2001 From: abuljko Date: Wed, 8 Jul 2026 09:01:05 +0200 Subject: [PATCH 07/10] Removed clickable sections --- source/components/software/nk-app1/index.rst | 20 ++++++-------------- 1 file changed, 6 insertions(+), 14 deletions(-) diff --git a/source/components/software/nk-app1/index.rst b/source/components/software/nk-app1/index.rst index a03ab5249a..e7782a08de 100644 --- a/source/components/software/nk-app1/index.rst +++ b/source/components/software/nk-app1/index.rst @@ -132,30 +132,22 @@ Linux Windows ******* -.. dropdown:: Windows - - Download .exe file from `here `__. +Download .exe file from `here `__. macOS ***** -.. dropdown:: macOS - - Download latest Nitrokey App (DMG file) `here `__. - **Note:** The Nitrokey App was not notarized by Apple yet, which is required by macOS 10.15. See this `forum post `__ for more information. +Download latest Nitrokey App (DMG file) `here `__. +**Note:** The Nitrokey App was not notarized by Apple yet, which is required by macOS 10.15. See this `forum post `__ for more information. FreeBSD ******* -.. dropdown:: FreeBSD +.. code-block:: bash - .. code-block:: bash - - $ pkg install nitrokey-app + $ pkg install nitrokey-app Source ****** -.. dropdown:: Source - - You can download and compile the source code from `here `__. In this case you may need to install `these UDEV rules `__ manually. +You can download and compile the source code from `here `__. In this case you may need to install `these UDEV rules `__ manually. From 9e0e359f63cf2e39248639a3c66ec5502b4bb6a2 Mon Sep 17 00:00:00 2001 From: abuljko Date: Wed, 8 Jul 2026 09:12:01 +0200 Subject: [PATCH 08/10] Syntax mistake fixed --- source/components/software/nk-app1/index.rst | 7 ------- 1 file changed, 7 deletions(-) diff --git a/source/components/software/nk-app1/index.rst b/source/components/software/nk-app1/index.rst index e7782a08de..5099658afe 100644 --- a/source/components/software/nk-app1/index.rst +++ b/source/components/software/nk-app1/index.rst @@ -3,13 +3,6 @@ Nitrokey App 1 The Nitrokey App 1 is a graphical application designed to manage Nitrokey Pro and Nitrokey Storage devices. For Nitrokey 3 devices, please use `Nitrokey App 2 <../nk-app2>`__. -.. toctree:: - :maxdepth: 1 - :glob: - :hidden: - - * - Installation ------------ From e9bb8ba2c991974c7b92c299d308efbb16236605 Mon Sep 17 00:00:00 2001 From: abuljko Date: Thu, 9 Jul 2026 12:12:51 +0200 Subject: [PATCH 09/10] Link NKApp2 to NKApp1 --- source/components/software/nk-app2/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/components/software/nk-app2/index.rst b/source/components/software/nk-app2/index.rst index a7ae4cb60a..480214270f 100644 --- a/source/components/software/nk-app2/index.rst +++ b/source/components/software/nk-app2/index.rst @@ -6,7 +6,7 @@ Available languages: English, German, French, Italian, Polish, and Arabic. Langu .. note:: - This application is compatible only with Nitrokey 3 devices. For Nitrokey Pro and Nitrokey Storage devices, please use `Nitrokey App 1 `__. + This application is compatible only with Nitrokey 3 devices. For Nitrokey Pro and Nitrokey Storage devices, please use `Nitrokey App 1 <../nk-app1>`__. Installation ------------ From 089071b913e6d20cf3b65b9768b58f56227dfb74 Mon Sep 17 00:00:00 2001 From: abuljko Date: Thu, 9 Jul 2026 12:43:40 +0200 Subject: [PATCH 10/10] CI fix --- source/components/software/nk-app1/index.rst | 2 +- source/components/software/nk-app2/index.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/source/components/software/nk-app1/index.rst b/source/components/software/nk-app1/index.rst index 5099658afe..fa50a9a3f2 100644 --- a/source/components/software/nk-app1/index.rst +++ b/source/components/software/nk-app1/index.rst @@ -1,7 +1,7 @@ Nitrokey App 1 ============== -The Nitrokey App 1 is a graphical application designed to manage Nitrokey Pro and Nitrokey Storage devices. For Nitrokey 3 devices, please use `Nitrokey App 2 <../nk-app2>`__. +The Nitrokey App 1 is a graphical application designed to manage Nitrokey Pro and Nitrokey Storage devices. For Nitrokey 3 devices, please use `Nitrokey App 2 <../nk-app2/>`__. Installation ------------ diff --git a/source/components/software/nk-app2/index.rst b/source/components/software/nk-app2/index.rst index 480214270f..a75486021f 100644 --- a/source/components/software/nk-app2/index.rst +++ b/source/components/software/nk-app2/index.rst @@ -6,7 +6,7 @@ Available languages: English, German, French, Italian, Polish, and Arabic. Langu .. note:: - This application is compatible only with Nitrokey 3 devices. For Nitrokey Pro and Nitrokey Storage devices, please use `Nitrokey App 1 <../nk-app1>`__. + This application is compatible only with Nitrokey 3 devices. For Nitrokey Pro and Nitrokey Storage devices, please use `Nitrokey App 1 <../nk-app1/>`__. Installation ------------