Install Dimension on VMware

WatchGuard Dimension is distributed as an OVA file for installation on VMware ESXi 6.0, 6.5, 6.7, or 7.0.

WatchGuard recommends you use the VMware vSphere Client to provision and install the OVA file.

After you install and start the virtual machine in vSphere, you run the web-based WatchGuard Dimension Setup Wizard to configure the basic settings for your new instance of Dimension.

Before You Begin

Before you can deploy the Dimension OVA file and set up your Dimension VM, you must:

  • Download the WatchGuard Dimension OVA file.
    From the WatchGuard Software Downloads Center, find and download the watchguard-dimension_2_2.ova file to install WatchGuard Dimension on your ESXi host.
  • Have a DHCP server configured in the network you choose for the Dimension virtual machine, if you want to use a DHCP server to get the initial IP address for Dimension. You can also manually set a static IP address for Dimension. You then use this initial IP address to connect to Dimension to run the Dimension Setup Wizard and complete your Dimension configuration.
  • Have an ESXi host configured where you can deploy your Dimension VM.

Install the Dimension Virtual Machine

Set a Static IP Address for Dimension

If you do not have a DHCP server, you must set a static IP address for the Dimension external interface. This is the IP address you use to connect to Dimension and run the Dimension Setup Wizard. To set a static IP address you make a console connection to Dimension with the wgsupport credentials and specify the IP address for the Eth0 interface.

The first time you make a console connection to Dimension, you must change the default password for the wgsupport user.

The command tool that you use to change the IP address is located in the /opt/watchguard/dimension/bin directory. To change the IP address, you must specify this directory, run the command, and type the new IP address and default gateway for the interface.

To make a console connection to Dimension and configure Dimension with a static IP address:

  1. Log in to the vSphere Client and select your Dimension VM.
  2. Start a console connection to your Dimension VM.
  3. Type the user name wgsupport.
  4. Type the passphrase readwrite.
  5. Type and confirm the new passphrase for the wgsupport user account.
  6. To set the static IP address for Dimension, at the command line, type:

/opt/watchguard/dimension/bin/ -i <IP address> -m <mask> -g <gateway>.

For example, to configure Dimension with a static IP address of and a gateway of, type:

/opt/watchguard/dimension/bin/ -i -m 24 -g

  1. Press Enter on your keyboard.

For more information about console connections to Dimension, see Console Access to Dimension.

Review the Dimension VM Settings

After you have deployed your new Dimension VM, you can power on the VM, review the settings for the VM, and find the IP address to use to connect to the WatchGuard Dimension web UI to run the Dimension Setup Wizard.

In the vSphere Client:

  1. In the ESXi host tree, select the Dimension VM.
  2. Select the Summary tab.
  3. In the General section, review the settings for the VM and make sure everything is correct.
  4. In the Commands section, click to power on Dimension.
    It can take a few moments for the Dimension VM to start up and get an IP address from the DHCP server.
  5. In the General section, find the IP address for Dimension.
    This is the IP address you use to connect to the WatchGuard Dimension web UI to launch the Dimension Setup Wizard .

Run the WatchGuard Dimension Setup Wizard

After your Dimension VM is set up and powered on, you can connect to Dimension to run the Dimension Setup Wizard and complete the configuration for your Dimension system.

Before you start the Setup Wizard, make sure you have this information to add in the wizard:

To run the Dimension Setup Wizard:

  1. Open a web browser and connect to Dimension at https://<Dimension IP address>.
    For example, if the IP address assigned to your instance of Dimension is, you connect to Dimension at
    The login page appears.
  2. Type the default user credentials:
    • User Name — admin
    • Passphrase — readwrite
  3. You will change the administrator passphrase when you run the Setup Wizard.

  4. Complete the wizard to configure Dimension.
    After you finish the wizard, the Dimension login page appears.
  5. Use the new administrator passphrase that you specified in the wizard to log in to Dimension.

After you have completed the wizard and logged in to Dimension, you can complete the configuration settings for your Dimension system and Log Server, create report schedules, and manage users, as described in these topics:

See Also

Install WatchGuard Dimension

Set Up & Administer Dimension

Manage Dimension System Settings