Headless Linux Client (bn-cli) Explained

Headless Linux Client (bn-cli) Explained


Big Network makes a headless linux client, named "bn-cli", available for linux server environments. bn-cli is used in cases where interactive login via our SSO platform may not be viable for use.

Download and Installation

You can download our Headless Linux Client from our portal download center (https://portal.bignetwork.com/) under the "other downloads" section. This client is packaged as both .rpm and .deb files for both ARM and AMD64 architectures. To use this client, install using your preferred package manager. 

Joining Cloud Networks with bn-cli

To join a cloud network, use the following command: 'bn-cli join $networkid" where $networkid is the Network ID taken from the properties of your Cloud Networks.

When you initially join a cloud network in this manner, the client will be denied access. You will need to manually allow the device to join the network in the portal. Navigate to your cloud network, tick the allow checkbox for the instance in question, and apply network changes. "bn-cli" will automatically join the Cloud Network once permitted.

NOTE: You must have available "Edge Node" licenses in your organization to join cloud networks in this manner. Your organization MUST be on a Business or Enterprise Plan. Edge Node is not supported in the Core Plan.

Leaving Cloud Networks with bn-cli

You can leave a cloud network with the command: 'bn-cli leave $networkid".

Other Useful Commands

  1. To view the client status, use "bn-cli info"
  2. To view networks joined by the client, use "bn-cli listnetworks"
  3. For debugging connectivity, use "bn-cli peers"

    • Related Articles

    • Big Network Technology Overview

      Introduction Big Network is a cloud managed connectivity platform that securely and instantly connects people, places, clouds and their devices anywhere. Big Network provides hardware, software and cloud services in one platform creating an open and ...
    • Troubleshooting Edge Lite - My Device shows Offline

      Troubleshooting Guide If your Edge Lite shows as offline, please execute the following debugging steps: Inspect the Device Please check power connections to the Edge Lite. Edge Lite is powered via a high power USB-C power supply. Please ensure the ...
    • Remote Access (VPN Substitute)

      Introduction Use this Configuration Guide to setup Remote Access using Big Network. Remote Access with Big Network is an ideal substitute to the traditional VPN. Design Diagram / Application Concept Design Diagram and Concept In this Configuration ...