Skip to main content

Installing dnclient CLI

This guide describes how to install the dnclient binary and use it to enroll a computer into your Managed Nebula network.

Linux​

  1. Obtain the URL for the latest version of the dnclient binary for your architecture from https://admin.defined.net/downloads.
  2. From a directory where you wish to download dnclient, run the following curl command, replacing <DL_URL> with the link you obtained from the downloads page.
curl -O <DL_URL>
  1. Make dnclient executable:
sudo chmod +x dnclient
  1. Install dnclient as a service. This will use the dnclient binary in its current directory, so move it first if you'd like it somewhere else.
sudo ./dnclient install
  1. Start dnclient. As a service, it will be started automatically on future reboots.
sudo ./dnclient start
  1. Enroll the host, replacing <ENROLL_CODE> with the enrollment code you receive from the Managed Nebula admin panel after creating or re-enrolling the host.
sudo ./dnclient enroll -code <ENROLL_CODE>

Your computer is now running dnclient and will be able to communicate with other machines on your Managed Nebula network.

macOS​

For macOS, we offer the dnclient CLI in two formats—as a standalone binary and packaged into a .dmg. The version in the .dmg is suitable for use in offline installations, since the signing information does not need to be retrieved from Apple servers. Otherwise, they are identical in functionality.

  1. Obtain the URL for the latest version of the dnclient binary or .dmg from https://admin.defined.net/downloads.
  2. From a directory where you wish to download dnclient, run the following curl command, replacing <DL_URL> with the link you obtained from the downloads page.
curl -O <DL_URL>
  1. If you downloaded dnclient.dmg, mount the image and copy the binary to your filesystem. Otherwise if you downloaded the binary directly, make it executable:
sudo chmod +x dnclient
  1. Install dnclient as a service. This will use the dnclient binary in its current directory, so move it first if you'd like it somewhere else.
sudo ./dnclient install
  1. Start dnclient. As a service, it will be started automatically on future reboots.
sudo ./dnclient start
  1. Enroll the host, replacing <ENROLL_CODE> with the enrollment code you receive from the Managed Nebula admin panel after creating or re-enrolling the host.
sudo ./dnclient enroll -code <ENROLL_CODE>

Your computer is now running dnclient and will be able to communicate with other machines on your Managed Nebula network.

Windows​

  1. Find the latest version of the DNClient.msi installer for your architecture from https://admin.defined.net/downloads.

  2. Download the installer directly from the downloads page, or in a PowerShell terminal started as Administrator on the host, run the provided curl command, replacing <DL_URL> with the link from the downloads page.

curl.exe -O <DL_URL>

  1. The MSI you downloaded can be double-clicked to be run and will install dnclient as a service. This will install dnclient, set it up as a service, and start it.

  2. In a PowerShell terminal run as administrator, run the following command to enroll the host, replacing <ENROLL_CODE> with the enrollment code you receive from the Managed Nebula admin panel after creating or re-enrolling the host.

& 'C:\Program Files\Defined Networking\DNClient\dnclient.exe' enroll -code  <ENROLL_CODE>

Your computer is now running dnclient and will be able to communicate with other machines on your Managed Nebula network.

On this page