Page tree
Skip to end of metadata
Go to start of metadata

Overview

This document provides the steps to use the Amazon Web Services (AWS) cloud service and the cPanel & WHM Amazon Machine Image (AMI) to build a production hosting environment. 

Warnings:

  • cPanel, Inc. only supports AMIs that list cPanel Inc as the seller. You can find seller information immediately below the AMI listing title.
  • We strongly recommend that you read the Amazon® AWS™ User Guide before you begin this process.
  • We strongly recommend that you do not install cPanel & WHM on servers that rely on snapshot data (for example, Amazon EC2™ Spot instances). When these servers revert to snapshot data, the system detects this action as a uniqueness change. This behavior causes these servers' cPanel & WHM licenses to lock due to the uniqueness changes for that server's cPanel & WHM license. A locked license disables a cPanel & WHM server.
  • This document assumes that you will use dedicated DNS instances, but you could also use these instructions on dual-use instances that serve as both web servers and nameservers.

Amazon’s AWS platform exists behind a NAT infrastructure. This infrastructure provides a solid hosting architecture that uses the following Amazon AWS features:

Note:

To complete this process, you must create and add a key pair to your AWS account and local computer.

  • For instructions to create and install a key pair, read our Instance Management Tasks documentation.
  • The key pair must use the same region as the instance.

Launch an Amazon AWS instance


 

Navigate to the cPanel & WHM AMI.

Navigate to the cPanel & WHM AMI in the AWS Marketplace.

Remember:

cPanel, Inc. only supports AMIs that list cPanel Inc as the seller. You can find seller information immediately below the AMI listing title.

The listing page for the cPanel & WHM AMI.

 

 

 


 

Select your region.

From the For Region menu, select the appropriate AWS region for your location. Then, click Continue. The Launch on EC2 interface will appear and display the 1-Click Launch tab.

Important:

You must configure the key pair and instance to use the same region in order to complete the launch process.

  • If they do not use the same region, you cannot use the key pair with the instance.
  • You cannot edit the instance region after you launch the instance.

The For Region menu on the AMI listing page.

 


 

Verify version settings.

By default, the system uses the AMI's default version to configure the instance version. Under Version, verify whether the system selected the desired AMI version. To select a different version, click Version and select a version.

Notes:

Verify the version information for your new instance.

 

 

 


 

Verify region settings.

The system uses the region that you selected in Step 2 to configure the instance region. Under Region, ensure that you selected the correct region. To select a different region, click Region and select a region.

Remember:

You must configure the key pair and instance to use the same region.

  • If they do not use the same region, you cannot use the key pair with the instance.
  • You cannot edit the instance region after you launch the instance.

Verify the region information for your new instance.

 

 

 


 

Select an instance type.

Under EC2 Instance Type, select the instance type that you wish to use. The list of instance types includes all of the types that the cPanel & WHM AMI supports.

Important:

  • Your EC2 instance type determines the rate at which AWS bills you.
  • Make certain that you select an instance type that includes appropriate resources for the type of system that you wish to run. If you will host a large number of websites or multimedia content, you must choose an instance type that exceeds our minimum system requirements.

Select the instance type for your new instance.

 

 

 


 

Configure VPC settings.

Under VPC Settings, verify the Virtual Private Cloud (VPC) and subnet that the system selected. To change one of these settings, click VPC Settings and select the desired VPC or subnet.

Notes:

  • To create a new VPC or subnet, click Create a VPC or Create a subnet, respectively.
  • For more information about VPCs and subnets on AWS, read Amazon's VPCs and Subnets documentation.

Verify the VPC and subnet for your new instance.

 

 

 


 

Configure security settings.

Under Security Group, verify the new instance's port and security settings.

Warning:

We strongly recommend that you select Create new based on seller settings, which the system selects by default. 

  • We recommend that only advanced users select default.
  • cPanel, Inc. has configured the Create new based on seller settings settings to meet cPanel & WHM's requirements and improve security for your system.

Security Group settings for your new instance.

 

 

 


 

Select a key pair.

Under Key Pair, verify whether the system selected the desired key pair. To select a different key pair, click Key Pair and select the desired key pair from the menu.

Remember:

  • The key pair must already exist in AWS and you must have already installed it on your local computer.
  • If you have not already created at least one key pair, the Key Pair section will display a Please create a new key pair. message. For instructions on how to create and install a key pair, read our Instance Management Tasks documentation.

Select the desired key pair for your new instance.

 

 

 


 

Launch the instance.

Click Launch with 1-click. A confirmation page that lists all of your instance's information will appear.

  • Click Return to Launch Page to return to the cPanel & WHM AMI listing in the AWS Marketplace.
  • Click EC2 Console to navigate to the EC2 Management Console. The EC2 Management Console allows you to launch EC2 instances, manage or check instance status, view DNS information, and other instance management tasks.

Note:

New instances may require several minutes to initialize. Until the initialization process finishes, the Status Checks column of the EC2 Management Console will display Initializing and an hourglass icon ( ).

Instance information on the confirmation page.

The EC2 Management Console's list of instances.

 

 

Additional documentation