We use cookies to ensure that we give you the best experience on our website.  Visit our Privacy Policy to learn more. If you continue to use this site, we will assume that you are okay with it.

Your choices regarding cookies on this site.
Your preferences have been updated.
In order for the changes to take effect completely please clear your browser cookies and cache. Then reload the page.

Installation of a virtual appliance

Checkmk Manual
Last updated: July 2 2020

Search in the manual

1. The virtual appliance

With the virtual appliance Checkmk virt1 you can run Checkmk as a guest on a virtualization platform such as VMware. VirtualBox is also supported and is particularly suitable for trying out virtualization.

The operating system and Checkmk itself are already pre-installed in the appliance. The appliance is ready for immediate use, is set up via a dialog, and can be configured via its own web user interface. You therefore do not need any Linux knowledge. The appliance is delivered in the Open Virtualization Format (OVF) – more precisely in its OVA (Open Virtualization Archive) archive format.

2. Download the appliance

Download the latest version of the OVA file in your customer portal, if you have a valid subscription with the virt1 option. As an alternative, you can try out the virtual appliance of the  Checkmk Enterprise Free Edition from our download portal . Select VMware ESXi / VirtualBox and then Base Installation. The size of the OVA file is about 750 MB.

3. Installation under VirtualBox

3.1. Prerequisites

For the following steps you need the OVA file, and an operational VirtualBox installation. It does not matter on which system VirtualBox is running.

3.2. Import the appliance

Start the import of the OVA file via File ➳ Import Appliance. You will immediately see all virtual machine settings – and can leave these as they are. Of course you can change the values at this point or later, for example, to give the machine additional resources.

Important: Under the appliance settings, it is essential to select the Generate new MAC addresses for all network adapters option in Mac Address Policy – otherwise problems will occur if multiple appliances with the same MAC address run on the network.

The appliance can now be imported.

After the import, you must perform another step: Call up the VM’s network configuration. The mode is set to Bridged Adapter here – the virtual network adapter is connected to an adapter on your host – and these of of course vary. In case of doubt simply leave the configuration without any changes with OK – VirtualBox then automatically selects your default adapter for the missing adapter.

This completes the VirtualBox-specific actions, and you can continue with the basic configuration of your appliance.

4. Installation under ESXi

4.1. Prerequisites

Prerequisites for the following procedure: You already have an ESXi server in the network with a data storage for the virtual machine’s configuration. You will also need the appliance’s OVA file.

4.2. Import the appliance

The import of the appliance runs largely automatically – only afterwards you should take another look at the network configuration.

  1. In the ESXi main navigation, select Virtual Machines.
  2. Start the import assistant via Create/Register VM.
  3. Select Import via OVA/OVF.
  4. Select the OVA file you downloaded before.
  5. Follow the assistant without doing any further changes.

The new machine will then be deployed, which may take a few minutes.

Important: The Checkmk virt1 is connected to a network interface of the E1000 type – an emulation of the 1 GB network adapter Intel 82545EM Gigabit Ethernet NIC – for which the drivers are usually already available. On an ESXi server, for better performance you should exchange the card for a card of the VMXNET 3 type, i.e. for a completely-virtualized 10 GB interface. To do this, install the VMWare tools and change the setting under virt1 ➳ Edit ➳ Network Adapter 1 ➳ Adapter Type.

You will now have completed the VMWare-ESXi-specific steps and can use your appliance’s basic configuration.