Installing the Newest Active Defense Harbinger Distribution

Alex King //

Hey all! I’m a temp intern (just over the summer) here. I spent a while working on the new Active Defense Harbinger Distribution (ADHD) release, so I’m going to do a quick walk-through on how to set it up for you to play with!

This version of ADHD is distributed differently than before. Instead of downloading a huge .iso file, you instead run a command in the prompt, and all the tools will be installed on your Linux machine. For this guide, I’ll be running a 64 bit ubuntu VM (available here) in VMware workstation player, a free product that can be downloaded here. Just follow the setup instructions for VMWare player, and you’re ready to set up your VM.

So, making our ubuntu VM. Open up VMware, and go to player > file > New Virtual Machine. You’re faced with a page of options for where the virtual machine comes from. Choose “Installer Disk Image File (iso)” and select the iso you downloaded earlier. Then continue, with “next”.

You are now confronted with an account creation page. Fill it in with whatever username and password you choose. I’ll use the credentials of the old ADHD. The next page allows you to name your VM. Choose whatever you like, and save it where you wish.

Next, select how much space to allocate for the virtual machine’s disk, and how it’s stored. I just stuck with the defaults.

Now, you should be on an overview of the settings you’ve chosen. However, we’re not done yet. Click on “customize hardware” to take care of a few more things.

You’re welcome to play around with the other settings, but the big thing that needs taken care of is under the “Network Adapter” section.

Once you’re there, select the “bridged” radio button to make sure your machine gets its own IP. Finish up in this menu, and then return to the overview. Leave “Power on this virtual machine after creation” checked for convenience, then click finish. It’ll take a while as it sets up our new VM, but when it finishes, you’ll be confronted with a login prompt. Log in with the password you chose earlier.

Now you’re ready to install the ADHD tools. Open up a command prompt (right-click on the desktop, then “open terminal”) and run the following command:

curl -sL | sudo bash -s

Note: There is a newer command to run.  Please check the readme for the latest install command.

After a while of downloading and installing tools, it will finish, and you’re done! The ADHD toolkit is installed on your VM. To get started using the tools, head over to for documentation. Best of luck!

Interested in viewing the source for ADHD? Check out the github at