How to Install Helix Core on Azure

Easily install a Helix Core instance on CentOS, RHEL or Ubuntu server in Azure. Use our template to set up in just a few clicks.

Get Azure Best Practices

Get Started with Azure Resource Manager (ARM)

The Perforce Helix Core ARM template uses our best practice Server Deployment Package (SDP) to set up a single VM instance with a single Data volume. This includes licenses for 5 free users and up to 20 workspaces.

Use the following instructions to get started in minutes.

  1. Navigate to the template, located on the Azure Marketplace.
  2. Click Deploy Azure or browse on Github. This allows you to create your own resource group.
  3. Fill out required parameters for your virtual machine (VM).
Parameter NameDescription
_artifactsLocationDefine a location where artifacts required by this template are stored including a trailing '/'. The default value is correct for normal deployments so does not need to be modified.
artifactsLocationSasTokenFor testing only – leave it blank.
locationDefine an Azure location (region) where these resources will be deployed. Defaults to the current user location within Azure portal.
OSDefine the operating system (OS) of the VM. Select "CentOS 7.x" (7.8+), "RHEL 7.x" (7.8+), or "Ubuntu 18.04 LTS". Defaults to "CentOS 7.x"
VMSizeSelect the size of the VM you wish to deploy. Read more about sizing options here.
We recommend compute-optimized instances, e.g. Fsv2 series options such as "Standard_F4s_v2" or "Standard_F8s_v2" etc depending on how many cores/RAM required.
Note: You can use a cheaper instance type to create and test, and then migrate to a more powerful (and expensive) for production.
Not sure what size you need? Start here >>
dataDiskSizeSelect the size of the data disk you want to deploy to hold your metadata, logs, and depot (archive files). This is an integer value in GB, with a minimum of 10 and a maximum of 2,048 (meaning 2TB).
p4PortDefine a P4PORT value to connect to server from your Helix Core client programs such as P4V (via ssl). Defaults to 1666.
swarmPortDefine a port for Helix Swarm (Apache) to be setup. Defaults to 80. Setting up with https will require suitable certificates to be installed.
adminUsernameDefine a username to use with ssh to access your VM. Default is "p4admin". Your ssh command would be “ssh [email protected]” if you leave it as the default value.
adminSSHPubKeySpecify a public key to access the VM via SSH for the adminUsername. You may use your own public SSH key or create one specifically for use with this instance.
source_CIDRDefine an IP access list. For security, we strongly recommend you only allow specific whitelisted IP addresses to access the server. By default, the server is wide open ("") which allows anyone to connect.
helix_admin_passwordDefine a password to access Helix Core as a super user for the account “perforce”. You will need to remember this value to login to the Helix Core server once installed and perform administrative tasks (such as creating depots or administering other user accounts).
  1. Click Review and Create.
  2. Once you have thoroughly reviewed, you are ready to deploy your instance.

Connect to Your Instance

  1. Connect to the provisioned instance with the P4PORT ssl:<IP Adress>:1666 as user “perforce” with the configured password (helix_admin_password) using a standard Helix Core client application such as P4V or the “p4” command line interface.
  2. Start coding!

Want Help Setting Up Perforce?

Contact our professional services team to talk with our experts. They can optimize your Helix Core servers for top performance.

Do More With P4V

Setting Perforce is easy with our P4V cheat sheet.

Read the Docs

Get step-by-step instructions on how to install, administer, optimize, and use Helix Core.