These steps guide you through installing and configuring Cirro on an Amazon Web Services EC2 instance.

Overview

It’s a four step process to install Cirro on AWS. Start by getting a Cirro account, creating a license plan, then download it. Then get a paid AWS account (Cirro requires 4GB of memory and cannot be run on a free account). Next, install and configure the instance. Last, complete Cirro configuration, restart and login.

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.

Get an AWS account

Get yourself an Amazon Web Services account.

Install and configure Cirro

Here you’ll choose the Cirro server, configure the instance, add storage and setup security, launch the instance and set keys, then SSH to the server to set a server name and DNS name if required.

Login and Launch Cirro Server

  • Login to your AWS account.

  • Choose your region.

  • Choose Cirro Server then click Launch

.

Choose an Instance Type

Cirro requires two cores and 4gb of memory.

  • Click 2. Choose Instance Type.

  • Choose Two Cores and 4GB of memory.

Configure Instance Details

Create a new Virtual Private Cloud and enable Public IP access.

  • Click 3. Configure Instance.

  • Click Create New VPC.

  • Enable Auto-assign public IP.

Add Storage

Cirro requires a minumum of 30GB to function efficiently.

  • Click 4. Add Storage.

  • Enter 30 (or greater) on the Root Volume.

Configure Security Group and ports

Cirro requires a number of ports to be open or closed to maintain security.

We recommend using an AWS security group or a local server firewall. If you use a local server firewall, then allow all traffic in your AWS group.

  • Choose 6. Configure Security Group

  • Create a new security group and name it.

  • Set ports as follows:

Type Port Range
SSH 22
HTTP 80
HTTPS 443
MS SQL 1433
MYSQL/Aurora 3306
PostgreSQL 5432
Oracle-RDS 1521
SMTP 587

Launch Instance and set the server Private Key

  • Choose 7. Review.

  • Click Launch.

  • Enter an existing PEM key here, or create a new one.

  • Click Launch Instances.

SSH to the server

Set a hostname on the box to avoid issues if IP addresses are changed.

  • SSH to the server using “ubuntu” as the username. For example:
ssh -i /keypem ubuntu@35.167.191.205

Next, set a hostname on the server to ensure IP address changes won’t affect Cirro.

cat /etc/hostname

cirroserver

When complete, your hostname will change to root@cirroserver

  • Reboot to restart nginx and Cirro Services
reboot

Set Server DNS Name (optional)

Update your DNS server with the name provided to the cirro server, and add the certificates to the cirro server.

Run these scripts to use free lets encrypt self-signed certificates.

sudo bash

curl https://get.acme.sh | sh

exit

sudo bash

acme.sh --issue --domain NEWSERVERDOMAIN --fullchain-file /etc/nginx/ssl/nginx.cert --key-file /etc/nginx/ssl/nginx.key --webroot /var/www/html/ --reloadcmd "service nginx reload"

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

Troubleshooting

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.