Install Cirro Server on Microsoft Hyper-V.


Before installation, you’ll need to get a Cirro account and setup a License plan. Then download the license and the server installer. Enable Hyper-V, then perform the installation and configuration steps. And last, complete post-installation tasks, reset the root password and setup the SMTP server.

Get a Cirro account and license

Start by creating a Cirro account and license plan.

Then download the license and installer.

  • Click Account at the top right of your account.

  • Download the License file.

  • Download the Hyper-V appliance.

Enable Hyper-V

Enable Hyper-V on your windows computer.

Install Cirro

Once you’ve copied the Virtual Appliance to the server, unzip it to the default folder.

Start Hyper-V

Start Hyper-V when ready.

Enable Bridge Mode

There’s two steps to setup Hyper-V for bridge networking.

  • First, create the virtual switch.

    • Start Hyper-V

    • Click Virtual Switch Manager.

    • Click New virtual network switch, then External and Create Virtual Switch.

  • Second, setup the switch

    • Name the switch (e.g., cirro network switch)

    • Choose External Network then choose the network connection.

    • Tick Allow Management… if there’s only one network connection.

    • Click OK.

Import Cirro Virtual Machine

Before you begin, unzip the Virtual Appliance file to the Downloads folder.

It’s a six-step process to install the Cirro Virtual Appliance

step 1-3 image
  • First, click Import Virtual Machine.

  • Then Click Next on the first wizard page.

  • Now, import the Virtual Machine.

    • Click Browse, open the download folder and select the Cirro folder.
step 4-6 image
  • Choose the Cirro appliance. If you get an error message or don’t see an appliance, go back to step 3 and drill down on the Cirro extract folder.

  • Next, register the virtual machine in-place, the default option and click Next >.

  • If queried, choose the connection you’ve just set up then Next >.

  • Last, click Finish on the summary page.

Start the Virtual Machine

Start the Virtual Machine and make note of the IP address.

VM started image

Post Installation

It’s a four step process to finalize the installation.

Cirro started in browser image
  • First, start the virtual machine and wait for the setup to complete. When successfully started, you’ll see these items at a command line interface:
Values Description Example
Connection URL Connect to Cirro with this address. This will differ from the example.
Cirro admin login credentials The Root user for your Cirro installation. This is the superuser with access to all functionality based on your license root/cirrouser
Linux server root credentials The root/superuser for the Virtual Machine. Use this to perform server commands root/linuxroot
  • Second, open a browser and enter the URL from the command line.

  • Third, add your license file.

  • Click Choose File and browse for your Cirro License file license.txt.

  • Fourth, add the Java Developer Kit JDK jdk-8u144-x64.tar.gz or greater.

    • Click Oracle Java Download and click accept license agreement then download the correct file.

    • Click Choose File and add the JDK file to Cirro once the download is complete.

  • Last, click Install to finish.

The browser will refresh and you’ll see the Upload Result Page. Either wait for the page to refresh, or do it yourself.


Check out the installation FAQs if you get into trouble.

Login to Cirro and disable Cirro Root user

For security reasons we recommend creating your own Cirro Super-user accounts.