This tutorial shows how to install and run Gradle Enterprise on Amazon EC2.
You can complete this tutorial in:
10 minutes (read the tutorial)
30 minutes (read the tutorial and perform the installation)
Gradle Enterprise can be installed on most modern Linux servers. The majority of this tutorial is a quick start guide to creating and minimally configuring an EC2 instance for a Gradle Enterprise installation. If you already have EC2 expertise and are able to provision an instance, you may wish to follow the general Gradle Enterprise installation instructions for generic Linux servers.
|If you are trialing Gradle Enterprise, you may prefer a free 30-day hosted trial that requires no installation or server.|
You can create a free account if you do not already have one.
Fill out this form to receive a free 30 day trial license. If you have purchased Gradle Enterprise, you will already have a license file.
Amazon EC2 machines are provisioned with generated host names such as
ec2-203-0-113-25.compute-1.amazonaws.com. If you want to access Gradle Enterprise by a host name of your choosing (e.g.
gradle.mycompany.com), you will need the ability to create the necessary DNS record to route this name to the Amazon EC2 address.
You are able to easily update this later. You can start with the name generated by AWS and later reconfigure to use a custom name if desired.
You will access your Gradle Enterprise instance via the public Internet. By default, traffic will be unencrypted. You can enable HTTPS in order to encrypt information being sent to Gradle Enterprise.
You may choose to have Gradle Enterprise generate a self-signed certificate, or provide your own. Using a self-signed certificate will require some extra configuration for the users of your Gradle Enterprise installation, but will result in traffic being encrypted.
You are able to easily update this later. You can start without HTTPS, or with a self-signed certificate, and later provide a trusted certificate.
In this section you will create an EC2 instance to run Gradle Enterprise.
Log in to Amazon AWS via the console page. Then, select “Services” from the top menu bar, and choose “EC2” in the “Compute” section of the dropdown that appears. Then, choose where you want your instance to run using the drop down on the top-right of the console screen.
You should generally pick the region closest to you geographically to ensure the best performance.
If you do not already have a key-pair for accessing AWS resources, you will need to create one. If you already have a key-pair that you wish to use, you can skip this step.
In the left hand menu on the EC2 page, click “Key Pairs” under the “Network and Security” heading. Click “Create Key Pair” and give it the name “Gradle Enterprise Keypair”. The keypair will appear in the list on screen, and your browser will download a file
SSH requires that only you have permissions to read PEM files, so you need to change the file permissions. Under Unix/Linux/OS X, this can be done by using the
chmod 400 /path/to/GradleEnterpriseKeypair.pem
Now in the left hand menu, you will see a link “Instances” under the “Instances” heading. Click this, and it will take you to a list of your current instances running in the AWS region you have selected. Create a new instance, by clicking the big blue “Launch Instance” button on this page.
You will be presented with a list of Amazon Machine Images to choose from.
If you do not have a preference, choose the most recent “Amazon Linux AMI” version that is supported by Gradle Enterprise. At the time of writing this is “2017.09.1”.
The list of supported operation systems supported by Gradle Enterprise can be found here.
At the time of writing, the simplest instance type that meets Gradle Enterprise’s minimum requirements is “t2.xlarge”. This instance type will be adequate for all but very heavily used installations.
Select your chosen instance type, and click “Review and Launch”.
Scroll down the review page until you see the “Storage” section, and click “Edit Storage”.
The suggested minimum storage space for Gradle Enterprise is 250GB.
For trial installations, the “General Purpose SSD” option is suitable. Production class installations should consider using “Provisioned IOPS SSD” for better performance.
Click “Review and Launch” to go back to the review screen.
The EC2 instance needs to be assigned to a security group that exposes the networking ports required to access Gradle Enterprise.
Scroll down the review page until you see the “Security Groups” section, and click “Edit security groups”. Choose “Create a new security group”, give the group a sensible name and description, and then add the following rules (as shown in the screenshot)
Port 22 for SSH
Port 80 for HTTP
Port 443 for HTTPS
Port 8800 for the admin console
Select “Anywhere” in the “Source” column, to allow access from any address (
Click “Review and Launch” to return to the review screen.
Click “Launch” on the review screen.
You will be asked to select a key-pair to allow you to SSH in to the instance.
Select the key-pair you created earlier (or an existing one you wish to use), and click the checkbox.
Click “Launch Instance” to start your server.
If you intend to use a custom hostname to access your Gradle Enterprise instance, you now need to add the appropriate DNS records.
A record for your hostname that points to the public IP address of your EC2 instance. You can find this IP address in the “IPv4 Public IP” field of the details panel when your instance is selected in the Instances table.
gradle-enterprise.company.com A 18.104.22.168
Alternatively, you can use the hostname generated by AWS. You can find the generated hostname in the “Public DNS (IPv4)” field of the details panel when your instance is selected in the Instances table (there’s even a handy “copy” icon next to it to copy the hostname to the clipboard).
Whichever you choose, from now on we will refer to this as
In this section you will install Gradle Enterprise on your newly created EC2 instance.
SSH into your instance with the following command:
ssh -i /path/to/pem/GradleEnterpriseKeypair.pem ec2-user@«hostname»
| The username
Once you’re on the machine, start the installation by issuing the command:
curl -sSL https://get.replicated.com/docker/gradleenterprise/stable | sudo bash
The installer will ask if you require a proxy to access the internet. Choose “No” to continue.
Once that has finished installing, open a web browser and navigate to
https://«hostname»:8800 to access the admin console (you will need to accept the warning in your browser due to there not being a valid SSL certificate).
«hostname» into the hostname field.
If you have a trusted SSL certificate for your hostname, you can upload it here. Otherwise, click “Use Self-Signed Cert”.
Choose a method for securing the admin console. Either Anonymous, Password, or LDAP, and select Continue.
The system will then perform some pre-flight checks, after which you can select “Continue”, and then select “Dashboard” from the navigation menu at the top of the page.
The latest version of Gradle Enterprise will begin downloading and will start automatically.
Once the dashboard shows “Started” in the left-hand panel, you can access Gradle Enterprise by either clicking “Open”, or by navigating to
Please consult the Getting Started with Gradle Enterprise guide for how to configure your Gradle builds to leverage your new Gradle Enterprise installation.