Linux

Prerequisites

Setup

To interact with the BrazenCloud utility, you need to either:

  • Set your working directory to the directory where the BrazenCloud utility is located

  • Add the directory where the BrazenCloud utility is located to your PATH environmental variable

For this walkthrough, we will assume that the BrazenCloud utility has already been downloaded and the working directory has been set to where the BrazenCloud utility is located.

For example, if you have downloaded the BrazenCloud utility to your Downloads folder, you can set your working directory in the terminal with:

cd ~/Downloads

You may also need to make sure that the BrazenCloud utility is allowed to executed with:

chmod +x runway.bin

Installation

From the 'Devices' view, click on the blue 'ADD ENDPOINTS' to get started.

Add endpoints button

This will open the 'Add Endpoints' modal:

Add endpoints Portal

In this context, the 'Download' button will download a Windows executable. This will NOT work on Linux.

The install command is listed under 'ENROLL USING A TOKEN'. Click on the green 'Copy' button and paste it into the terminal after sudo

Note: You may have to adjust the command slightly to account for the name of the BrazenCloud utility by adding a ./ in front of runway and a .bin after. The full command would look similar to:

sudo ./runway.bin -S portal.runway.host install -t <token>

Installation success

After executing the install command you should see the following in the terminal:

> Installation success!
> Exiting.
BrazenAgent install finished with code (0)

Now, if you switch back to the BrazenCloud portal, you should see your endpoint on the device list, with a green circle to show that the BrazenAgent is active and ready to be assigned a Job.

Last updated