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.


To use the headless linux client, you must be using a Business or Enterprise Platform Edition. Navigate to Portal -> Organization -> Billing -> Servicer Plan Overview to view your edition.

To view available licenses for use with the headless linux client, navigate to Portal -> Cloud Networks; review your Edge Node Licenses at the top of the page.

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

    • Edge Virtual: Installation and On-Boarding on the Linux KVM Hypervisor

      Introduction This guide provides instructions to install and on-board Edge Virtual on the Linux KVM Hypervisor. Our guide is based upon KVM deployed on Ubuntu 20.04 LTS. Note: Edge Virtual is available in a Limited Release at this time. Assumptions A ...
    • 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 ...
    • Deploying Resilient Internet Access with Edge Pro

      Introduction Big Network Edge Pro is the ideal platform to provide resilient Internet Access to offices, branches, or remote locations. Sites seeking high availability of Internet access can use Edge Pro to "abstract" underlying ISPs, such as mobile ...
    • 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 and Concept of Operation Design Diagram / Application Concept In this ...