Deploy Develocity on Amazon EC2

Estimated Effort: 15 minutes

This setup is intended for evaluation and testing purposes only. It isn’t recommended for production environments.

This guide doesn’t include SSL setup because it’s intended solely for evaluation purposes; you must enable SSL in production environments.

This guide doesn’t work on GovCloud accounts (us-gov regions).

Overview

This guide walks you through quickly deploying Develocity on an Amazon EC2 instance. It assumes that you have a basic understanding of AWS and EC2.

If you aren’t familiar with AWS and EC2 and need more detailed step-by-step instructions, follow the Amazon EC2 Standalone Installation Guide.

This guide uses the AWS Management Console to create an EC2 instance and the Amazon EC2 console to connect to the instance.

You publish your first Build Scan to your Develocity instance using the Build Scan® example project.

Before You Start

Before you start, ensure that you have the following:

Account and access

  • An AWS paid account (a free tier account isn’t sufficient)

  • An AWS IAM user with the AmazonEC2FullAccess AWS managed policy

  • Familiarity with launching and managing EC2 instances

License

  • A Develocity license. If you have purchased Develocity or started a trial, you have a license file called develocity.license. Otherwise, you may request a Develocity trial license.

Local software (install on your local machine, not on the EC2 instance)

  • curl

  • git

  • A terminal

  • A Java Development Kit (JDK)

Launch an EC2 Instance

  1. Go to the AWS Management Console and sign in with your credentials.

  2. Navigate to the EC2 Dashboard and select Launch instance.

  3. Select the Ubuntu 26.04 LTS AMI for the x86_64 architecture. In the AMI search, look for the official Canonical AMI (owner ID 099720109477).

  4. Choose the m7i.4xlarge instance type.

  5. Configure the instance with the following settings:

    Key pair (login)

    Select your key pair.

    Network settings

    • Assign a public IP (needed for the Amazon EC2 console).

    • Select Create security group.

    • Allow SSH (default: Anywhere 0.0.0.0/0).

    • Allow HTTPS access (port 443).

    • Allow HTTP access (port 80).

    Configure storage

    Add 300 GiB of storage using a gp3 volume.

  6. Review your configurations and launch the instance by selecting Launch instance.

The following table summarizes the configuration settings for reference.

Example Configuration
Setting Value

AMI

Ubuntu 26.04 LTS (x86_64)

Instance Type

m7i.4xlarge

Key Pair (Login)

Select an existing key pair

Network: Public IP

Enabled

Network: Security Group

Create new

Network: SSH

Allowed from anywhere (0.0.0.0/0)

Network: HTTPS

Port 443 allowed

Network: HTTP

Port 80 allowed

Storage

300 GiB, gp3 volume type

Once the instance is running, navigate to the EC2 Dashboard EC2  Instances, select your newly created instance, and note the Public IPv4 DNS. You need this URL during the installation.

Installation

The installation process involves uploading your Develocity license, downloading the installation script, and running it on your EC2 instance.

Connect to the Instance

  1. In the AWS Management Console, navigate to EC2  Instances and select your instance.

  2. Choose Connect.

  3. On the EC2 Instance Connect tab, choose Connect.

A browser-based terminal opens. Run the following commands to update the instance before proceeding:

sudo apt update -y && sudo apt upgrade -y

If prompted to restart services or reboot, do so before continuing.

Upload Your Develocity License to the EC2 Instance

On the instance, create a new file called develocity.license, copy-and-paste your Develocity license into this file and save it.

Download and Validate the Installation Script

Download the ec2-install.sh and the ec2-install.sh.sha256 files from GitHub by running the following curl commands:

Download the script:

curl -O https://raw.githubusercontent.com/gradle/develocity-quickstart-scripts/refs/heads/main/AWS/EC2/ec2-install.sh

Download the checksum for validation:

curl -O https://raw.githubusercontent.com/gradle/develocity-quickstart-scripts/refs/heads/main/AWS/EC2/ec2-install.sh.sha256

Validate the script against the checksum:

sha256sum -c ec2-install.sh.sha256
Output
ec2-install.sh: OK

The values generated by the sha256sum utility must match. If they differ, your download is incomplete or corrupted. Download the files again.

If, after several attempts, you can’t download a copy of the file that produces a valid checksum value, you should open a support case to report the problem.

Adjust the permissions of the script to make it executable for your user: