Install Cirro server in Oracle Virtualbox.


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, then 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.

Install and configure Cirro

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.

Add a NAT network adapter

Use these steps to check if there’s a NAT network adapter in Virtualbox, and to add one if necessary.

  • Select Tools then File and Preferences.

  • Choose Network then + to add a network if necessary.

Set Bridged Adapter for Virtual Appliance

Enable a bridged network using these steps.

  • Begin by selecting the Virtual Appliance then Machine and Settings.

  • Next, click Network then choose Adapter 1, then Bridged Network from Attached to.

  • expand Advanced on Adapter 1 and note the Mac Address.

  • Click Ok when finished

Setup the Virtual Appliance network

Now setup the network on the Virtual Appliance.

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.