Skip to main content

Example: Install on VirtualBox

This guide provides an example of how to install the Dronetag On-Premise solution using Oracle VirtualBox. The steps are similar for other virtualization platforms, but the interface may vary slightly. We provide these steps as an example, as-is, and you may need to adapt them to your specific virtualization platform. This guide was written for Oracle VirtualBox version 7.1.10 (2025).

1. Import the OVF file​

To import the OVF file into Oracle VirtualBox, follow these steps:

  1. Open Oracle VirtualBox.
  2. Go to File > Import Appliance.
  3. Select the dronetag-onpremise*.ovf file from the distribution package.
  4. Click Next and review the appliance settings.
  5. Click Import to start the import process.

or use this command:

VBoxManage import --vsys 0 --vmname "dronetag-onprem" dronetag-onpremise*.ovf

2. Configure the machine settings​

After the OVF file is imported, you may want to review and adjust the machine settings.

You can use the defaults settings, but you will need to adjust the network settings to ensure the virtual machine can communicate with your host machine and the rest of your network.

  1. Select the imported virtual machine in VirtualBox.
  2. Click on Settings.
  3. Make sure you're in the "Expert" mode, not "Basic" mode.
  4. Go to the Network tab.

Now choose one of the following options for networking:

2.1. Use NAT​

  1. Ensure the network adapter is set to NAT.
  2. Click on Port Forwarding.
  3. Add the following port forwarding rules, set protocol to TCP, host IP to 127.0.0.1 (or leave it empty for all interfaces), and host port to the desired port on your host machine:
    • 22 - SSH port to access the virtual machine over SSH
    • 80 - HTTP port for the web interface
  4. Click OK to save the settings.

VirtualBox Port Forwarding Window

or configure using the command line:

VBoxManage modifyvm "dronetag-onprem" --natpf1 "guestssh,tcp,,9022,,22"
VBoxManage modifyvm "dronetag-onprem" --natpf1 "guesthttp,tcp,,9080,,80"

2.2 Use Bridged Adapter​

  1. Ensure the network adapter is set to Bridged Adapter.
  2. Select the network interface of your host machine that is connected to your local network.
  3. Click OK to save the settings.

or configure using the command line:

VBoxManage modifyvm "dronetag-onprem" --nic1 bridged --bridgedadapter1 "<your adapter>"

3. Start the virtual machine​

  1. Select the imported virtual machine in VirtualBox.
  2. Click on Start to boot the virtual machine.

or use this command:

VBoxManage startvm "dronetag-onprem"