Skip to content

Install Connect on Linux

CyberHive Connect client packages are distributed via an APT repository at https://pkgs.cyberhive.com/

Configuring the APT repository

First import the PGP key:

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://pkgs.cyberhive.com/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/cyberhive.gpg

Use the following command to set up the repository:

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/cyberhive.gpg] https://pkgs.cyberhive.com/stable/ubuntu focal main" | \
sudo tee /etc/apt/sources.list.d/cyberhive.list > /dev/null

Installing the client

Update to get the latest package information:

sudo apt update

Then install the client:

sudo apt install cyberhive-connect

Note

See Upgrade Connect for details of how to upgrade the client.

Configuring the service

The client supports installation of a service under multiple service management frameworks: systemd, launchd, upstart, runit, and sysv init.

We'll describe configuration under systemd here. The same environment variables would need to be configured under other frameworks; see the documentation of your selected framework for more information.

Populate /etc/default/cyberhive-connect; you'll need to establish the specific values with your system administrator, and replace the example values shown here:

CONNECT_SERVER=https://instance-id.connect.cyberhive.com/
[email protected]
CONNECT_AUTH_TOKEN=auth_token
CONNECT_LISTEN_PORT=18025
CONNECT_OVERRIDE_HOSTNAME=node_name

See also man cyberhive-connect for more information on the available settings.

Tip

It is also possible to pre-generate keys for the endpoint.

Enable and start the service

Again under systemd, enable the service and start it immediately:

sudo systemctl enable --now cyberhive-connect.service

Interactive Usage

It is possible to run the client interactively in a graphical environment by running the cyberhive-connect binary with -s and -u switches.

See man cyberhive-connect for further details.