These steps guide you through installing and configuring Cirro on Parallels.


Before installation, you’ll need to get a Cirro account and setup a License plan. Then download the license and the server installer. Install Virtualbox to convert the Cirro Virtual Appliance, then install Parallels and import Cirro. Next, perform the installation and configuration steps. And last, complete post-installation tasks, reset the root password and setup the SMTP server.

Installation Requirements

Your server needs to meet these minimum requirements to install Cirro.


Each server must include:

  • Minimum: 2 Core CPU, 4GB
  • Recommended: 4 Core CPU, 8 GB (Additional 4 GB per 10,000 queries per hour)
  • Hard Drive: 5 GB for installer, 30GB at least for query history retention.


  • Outgoing traffic - Whitelist all Database IP addresses.
  • Network - enable the network so the system can download packages.

Before You Start

Install VirtualBox

Get Virtualbox and install.

Start the application when ready.

Import Cirro to VirtualBox

Follow these five steps to import Cirro to VirtualBox.

  • First, click File then Import Appliance.

  • Next, open the file browser.

  • Third, select the .OVF file and click Open.

  • Back in Import Appliance, click Next or Continue depending on your OS.

  • Change the file path if required.

  • Choose include all network adapter MAC addresses.

  • Click Import.

Clone the Virtual Appliance

It’s a three step process to clone the Virtual Appliance so it can be used with Parallels.

First, right-click the vm virtual appliance and choose Clone.

Second, make some changes to the settings:

  • rename the clone file to “cirro_parallels”.

  • change the file path if required.

  • choose include all network adapter MAC addresses.

  • Click Continue.

Third, choose Full Clone and click Clone.

Install Parallels

Get Parallels and install.

Start the application when ready.

Import to Parallels

Open Parallels Control Center then follow these four steps to import the virtual appliance.

First, right-click the parallels icon and choose Control Center.

Second, choose File then Import.

Third, find the cirro_parallels.vbox file you saved earlier. Click Open.

Last, name the virtual appliance in Parallels, choose a folder then click Convert.

Once the import is complete, the virtual appliance will start with the localhost IP address.

Enable network

You’ll need to configure Parallels to connect to your network next.

Start by shutting down the virtual appliance.

  • Login to the VM with the username and password supplied.

  • Shutdown with this command and enter the cirro password when prompted:

sudo poweroff

Next you’ll set the network source in Parallels and enable networking in Cirro.

Select network source

Follow these three steps to set the network source. Choose whichever network your computer is connected to, such as Ethernet or Wifi.

  • First, click the icon on the virtual appliance to open settings.

  • Next add Networking

    • Click the hardware icon.

    • Click + and choose Networking.

  • Third, choose your network type.

    • Click Network.

    • Click Source.

    • Choose your network type (e.g., Ethernet). Parallels will tell you if this is valid.

Enable networking in Cirro VM

Now start the virtual appliance again and follow these instructions.

Description Command Example Values/Results
Start the Virtual machine, then login as the system root user.   Cirro/Cirro2018
Use Superuser. sudo su -
sudo su -
Run ifconfig to compare the MAC addresses from earlier. ifconfig -a enp0s17 Link encap:Ethernet Hwaddr: 80:00:00:00:nn:00
Open interfaces.d directory. cd /etc/network/interfaces.d  
Create the adapter file if it doesn’t exist. touch {adaptername} touch enp0s17
Use Vi to edit the network adapter name. vi {adaptername} vi enp0s17
Add these lines to the file. auto {adaptername}
iface {adaptername} inet dhcp
auto enp0s17
iface enp0s17 inet dhcp
Quit Vi with these keyboard buttons. ESC
Restart the Virtual Machine reboot  

Once restarted, the IP address should be different.

VM started image

Post Installation

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

  • 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.

  • 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.