Skip to main content
All CollectionsGuides for dashboard.dispel.ioAdmin User GuidesWicket Installation Guides
How To: Install a Dispel Virtual Ubuntu Wicket ISO — Full Auto-Install Wicket Guide
How To: Install a Dispel Virtual Ubuntu Wicket ISO — Full Auto-Install Wicket Guide

This document walks you through building a virtual machine, installing a Dispel Ubuntu Wicket ISO, & testing connection to Dispel's network.

Maya Shah avatar
Written by Maya Shah
Updated yesterday

When to Use Virtual Ubuntu Wicket ISOs

In scenarios where a hypervisor (e.g., VMware, Hyper-V, or VirtualBox) is available on an on-site machine, Virtual Ubuntu Wickets can be deployed. This option allows you to integrate the Wicket seamlessly into your virtualized environments. This wicket is the standard recommendation, as it is used for most customer deployments, does not require cloud configurations, and does not require the purchasing of hardware.

Guide Overview

This guide assumes you have received the Wicket ISO file from the Dispel team. This walkthrough is broken down into three sections:

  1. Building the virtual machine (VM)

  2. Installing and configuring the Dispel Wicket ISO image onto the VM

  3. Verifying successful connection to the Dispel Network

Pre-Requisite: Downloading the Ubuntu Wicket ISO

💡 To start this process, you will need a custom ISO file from Dispel. This ISO file will contain everything needed for your Wicket—including the OS, network configurations, and Wicket licensing. Simply build the VM with the specs below, attach the Wicket ISO, and boot up the machine.

Please ensure that your downloaded iso file is not corrupted. To verify the integrity of your downloaded Wicket ISO file prior to installation, visit the guide linked below.


Installation Process

Building the Virtual Machine

  1. Create a virtual machine with:

    • Ubuntu 64-bit as the Type/Architecture

    • (Min) 4 GB RAM

    • (Min) 25 GB storage

    • 2 vCPU

    • Two network interfaces, one with access to external Internet and the other with access to the target network.

      • *Note: Wickets can be configured with a single interface if necessary.

  2. Attach the Ubuntu Wicket ISO to the virtual machine.

  3. Boot up the machine.

Installing and Configuring the Wicket ISO Image on the VM

  1. Once you mount the ISO and bootup the machine, the installer will automatically run to completion, and turn off the machine.

    1. Please confirm that the machine’s NICs are properly configured, as the wicket will setup its network on its first boot automatically.

  2. The installer will attempt to remove the ISO automatically, but some hypervisors do not allow this. Please confirm/remove the ISO and boot up the machine.

    1. The first boot will take a little longer than normal as there are many things that are configured at this time.

  3. When boot up is finished you will be presented with a login screen. Login with the credentials you were provided with the ISO.

Verifying Successful Connection to the Dispel Network

  1. After 2 Minutes: In the command line, type ifconfig.

    1. Verify that two interfaces named tun100 and tun101 appear.

    2. Verify the Network Interface addresses are correct.

  2. Verify the wicket can reach the Dispel Production Server with ping 10.100.1.1.

  3. A Dispel team member should verify that the Wicket is visible from the Moving Target Defense Region (Dispel Network).

Did this answer your question?