The Nano Client is available in prebuilt binary distribution packages for major platforms. Most users will wish to use these for convenience. People who wish to install from source can find the guide here as well. Either way, download the files of your choice from the download page.
Common Criteria Certification¶
Some versions of the Nano client will be CC certified. You can see the certified versions on the download page.
Keep in mind, that only the binary software distributions are covered by the CC certification of any version of Nano.
To check if your Nano is certified, open the “About” window and verify that your version was published with CC certification.
Furthermore, the “Common Criteria” tab in the “About” window gives a summary and lists the relevant configuration that are necessary for CC certificated operation. Overview of the relevant configuration(s):
Require explicit peer trust: This configuration changes the identity verification policy of Nano from trust-on-first-use (TOFU) to verified-only. If it is switched on, no peer may request anything from the Nano from any room unless the owner has verified their identity in the web application.
The “Identity verification” functions are only available as technology preview in the web application. The experimental “Identity Signature” feature in the “Advanced Settings” must be switched on to access them.
The prebuilt applications have all of their dependencies bundled. They should work if the OS requirements are met.
For Windows the prebuilt application is available as an installer executable. It will extract the application into the Program Files and create a start-menu shortcut. Creating a desktop and an auto-start on login shortcut can be disabled.
For macOS there are two dmg (virtual disk image) files available. One for Intel (64bit) systems and the other for the new Apple Silicone (M1) systems. Download the image of the application corresponding to your device.
Double-clicking on the downloaded file will verify and mount the distribution image. It will contain the Nano client application called Clarabot Nano and a link to your Applications folder. Dragging the Clarabot Nano to the Applications folder copies it to the system conveniently. The Gatekeeper will verify and prompt you when running the application for the very first time.
For Linux we provide an AppImage containing the application. It is built on a fairly EOL distribution so most systems should have no trouble running it. On recently released systems some compatibility packages may be need for running it, like libxcrypt-compat on Arch Linux.
Installing from source¶
This guide is applicable to all platforms, but it focuses on Linux. This guide is a simple recommendation to give an overview of the steps necessary, but other customizations and configurations are possible.
Python version 3.10
wxWidgets 3+ (for compiling wxPython)
protobuf library (for compiling gcld3)
dbus library (for compiling dbus-python)
OpenJDK (Java) 11
Download the latest source package of clarabot-nano and clarabot-crypto from the downloads page
Create virtualenv for nano installation
python3.10 -m venv ~/.nano && source ~/.nano/bin/activate
Install the wheel package before any other
pip install wheel
Install clarabot-crypto and clarabot-nano packages
pip install clarabot-crypto-X.X.X-src.zip clarabot-crypto-X.X.X-src.zip
Launch clarabot_nano. It will stop with an error at this point, but it will bootstrap the local configuration. Close it
python -m clarabot_nano
Create directories for solr and tika
mkdir ~/.nano/tika ~/.nano/solr
Copy tika-server-standard-X.X.X.jar to ~/.nano/tika/
Extract solr-X.X.X.tgz and copy the contents of the extracted solr-X.X.X directory to ~/.nano/solr/.
cd ~/.nano/solr && tar --strip-components=1 -xf solr-X.X.X.tgz
~/.config/clarabot/nano/local.ymlby uncommenting and setting
/home/YOUR_USERNAME/.nano/tika. They are at the bottom of the file.
Start nano with
python -m clarabot_nano
Create script to start nano by saving the following to a file, set execute permissions with
chmod +x filename, then double-click on the file to run nano
#!/bin/bash source ~/.nano/bin/activate python -m clarabot_nano
After starting the application, log in with your Nano user account credentials. If you don’t have a Nano account set up, make sure to do so by following the steps explained in the Registration chapter.
The Nano Client comes with a default configuration wizard. The wizard will help you in setting up your client for first time general usage.