Installation Guide

Each major Bright version release is accompanied by a correlating Bright CLI version that supports it. To enjoy the full functionality of the Bright CLI, we recommend that you periodically check for a new version of the CLI and reinstall it if needed. Thus, you will also avoid potential errors that may be caused by some critical changes issued with a release.

To install the Bright CLI for the first time and reinstall it to update the version, use the installation options given below. For release notes describing the changes in each new version, see here.

Technical requirements

To install the Bright CLI, you will need a local machine with the following specifications:

  • System: Ubuntu OS / Windows 8+ / MacOS / Docker 20+
  • Processor: x86 or x64 1 core (minimum), 2 core (recommended)
  • RAM: 512 MB (minimum), 1 GB (recommended)
  • Hard disk: up to 512 MB of available space may be required
  • The Docker compose or NodeJS (v10+) installed

Prerequisites

  • Make sure you have the proper access rights to install components on your machine.
  • If you are already using the Bright CLI, but you have decided to use another installation option, please remove the initial Bright CLI service first to avoid possible conflicts of the installers.

Installation options

  • If you a new user, you can install the Bright CLI as part of the onboarding procedure:

Docker install

NPM install

Windows install
  • If you have already created an account, but have not got the Bright CLI installed, you can use one of the options below.

👍

Tip

You can always return to the onboarding wizard and complete the initial setup, including installing the CLI and connecting the Repeater. For that, on the top right of the app, click , and then select Repeater setup wizard.

Docker

A preconfigured Repeater Docker version is available on https://hub.docker.com/r/neuralegion/repeater

🚧

Important

There is a temporary issue when apps started from the Docker containers don't have access to ports of the physical PC where the Docker is started. So as a result the “CONNECTION_ERR” message appears because the Repeater is trying to link by the virtual port, where are no started apps.

There are two ways to interact with the Repeater started from the Docker container, and target apps running on the local machine:

  • The target app is running in a Docker container
    In this way, an extra parameter --network host should be added. The whole command for launching the dockerized Repeater should be:
    docker run -it --network host neuralegion/repeater repeater --id iT2VXTu2W2mqgfAU78bbKr --token YOUR_TOKEN --cluster YOUR_CLUSTER.
  • The target app is running on a physical port of the local machine outside of the Docker container
    To avoid this situation, use thehttp://host.docker.internal target URL Instead of specifying http://localhost.

NPM

🚧

Important

Currently the supported versions of NodeJS are between 10.x and 14.x (included).

To install the CLI using , run the following command:

npm install -g @neuralegion/nexploit-cli

📘

Note

The installation command may not be supported by some Linux distributions. In this case, you need to download the installation package from GitHub and deploy it manually.

More information can be found on our npm page.

Windows installer

To install the CLI using a Windows installer:

  1. Go to the installation page.
  2. Under Assets, download the nexploit-cli.msi file.
17631763
  1. Follow the instructions given in the installation wizard.