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.
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:
Launch Instance and set the server Private Key
Choose 7. Review.
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 email@example.com
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
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"
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:
|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.
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.