Skip to main content
Sign in

Linux

Barrett Harper
  • Updated

The Banyan Linux Desktop App allows you to register your Linux device so it can start accessing Banyan-secured Services.

 

The Banyan Desktop App can be downloaded at https://www.getbanyan.app

 

  • For Ubuntu 20.04+ users, download the Debian package - DEB
  • For Fedora 34+ users, download the Red Hat Package Manager - RPM

 

 

Prerequisites

Before proceeding through the steps below, please ensure that you have administrative privileges on your Linux device in order to install the Banyan Linux Desktop App. 

 

Ensure the following prerequisites are met:

  • You must have Chrome installed, set as your default browser, and used for registering your device and connecting to services.
  • If not already installed, Ubuntu users need to have certutil installed. To install certutil, launch your terminal and run the command sudo apt-get install libnss3-tools

 

 

  • If not already installed, Fedora users need to have nss-tools installed. To install nss-tools, launch your terminal and run the command sudo dnf install nss-tools

 

fedoranss-tools.png

Install the Banyan Linux Desktop App

 

NOTE: If your device is corporate-owned and -managed (using a Device Manager), then these installation and registration steps may be preconfigured and omitted.

To install the Banyan Linux Desktop App:

 

1. Run the banyanapp .deb or .rpm installer.

ubuntuappinstall.png

Fedoraappinstall.png

 

2. Click Install and allow the installation to finish.

ubuntupressinstall.png

 

3. Launch the Banyan Linux Desktop App.

ubuntulaunchapp.png

 

4. Enter your organization's Invitation Code. This Invitation Code is provided offline by your Admin. Then, click Continue.

register.png

 

5. Authenticating with an IDP (such as Okta, G Suite, OneLogin, or other SAML IDP) launches a new browser window. The example below shows an organization using Okta to authenticate its users.

OktaSignIn.png

 

A success message displays.

 

LoginSuccessful.png

 

6. Select the ownership type of the device you are registering.

 

DeviceOwnership.png

 

You can now access Banyan-secured applications and services from your Linux device.

 

NOTE: Once you have installed the Banyan Linux Desktop App, you can access it at any time via the menu bar.

 

Related articles

Comments

3 comments

Date Votes
  • Fabrizio Cirelli

    For Fedora I think it's needed:

    sudo dnf install nss-tools

    Instead of libnss3-tools

    1
  • Tanner Kelley

    We will be updating our docs for Fedora specifically tomorrow!

    0
  • Fabrizio Cirelli

    I had some unsolvable problems with version 3.2:

    [2022-08-29 16:43:52.274] [info]  Installing client certificate
    [2022-08-29 16:43:52.408] [info]  Client certificate installed
    [2022-08-29 16:43:53.833] [error] Error: Trying to write tokens without secrets.
    [2022-08-29 16:43:53.833] [error] Unable to finalize registration There was an error registering your device. Please try again.

    I had to rollback to 3.0.
    Fedora 36

    0

Please sign in to leave a comment.