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.
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
- 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.
- If you a new user, you can install the Bright CLI as part of the onboarding procedure:
- If you have already created an account, but have not got the Bright CLI installed, you can use one of the options below.
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.
A preconfigured Repeater Docker version is available on https://hub.docker.com/r/neuralegion/repeater
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
--networkhost should be added. The whole command for launching the dockerized Repeater should be:
docker run -it --network host bright/repeater repeater --id YOUR_REPEATER_ID --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 the
http://host.docker.internaltarget URL Instead of specifying
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 @brightsec/cli
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.
To install the CLI using a Windows installer:
- Go to the installation page.
- Under Assets, download the
- Follow the instructions given in the installation wizard.
Updated 5 days ago