Enhanced Studio Pack on Azure

The Enhanced Studio Packcontains all the tools you need to do world-class development in a single, pre-configured environment. Use these instructions to deploy everything you need with the infrastructure required to support large projects, big files, and all your team members.


Helix Core Version Control

Helix Swarm Code Review

Helix Plan Project Management

Define Your Azure Environment

  1. To deploy your Enhanced Studio Pack on Azure, click on the template link in your email (you will receive one after signing up). It will open the Azure Portal Custom Deployment page after you log into your Azure Account.
    In the template, you will see steps on how to define your Perforce environment. Review each step and select or change options to customize your Perforce Enhanced Studio Pack.
  2. Define your parameters:


You must have an existing subscription to deploy. An Azure account can contain multiple subscriptions.

  1. Select a subscription to host your Perforce Enhanced Studio Pack.
  2. New to Azure? Calculate your potential costs >>  

Resource Groups

When deploying on Azure, multiple resources will be created, and will be placed in a single Resource Group. This allows you to easily see what items are related to this deployment.

  1. Select an existing resource group or create a new one.
  2. We recommend creating a new resource group that will be specific to this deployment. If you create new, example name: perforce-${environment}-${team/department}


  1. Select the region closest to your end users or a region that meets your compliance/security needs.


The Environment parameter is used in both resource naming and the tag on all resources.

  1. Environment default is “prod.” We do not recommend changing this name. But it can be done if your needs require it.

Virtual Network Configuration

  1. You can use an existing Azure VNet or create a new one. We recommend creating a new one. Use your organization’s network naming convention.
    • If you will be using an existing VNet you will need to map the Public Subnet and Private Subnet dropdowns to your existing public and private subnets.
  2. To start, you must add at least one IP address. We recommend using the public IP address of the machine being used to set up the stack in Azure.
  3. Replace with your IPv4 address. Find your IP address >>
    /32 will remain unless there is a continuous block of IP addresses that need to be whitelisted. You can always add and delete IP addresses after you deploy.

Configure Perforce Tools

Now that you have selected server parameters you can configure Perforce tools.

Helix Core Configuration

Define how your Helix Core server will be setup.

  1. To set up SSH, upload an existing key or create a new one. Certain admin actions will require SSH access. For example: operating system updates, product updates, reviewing logs, or expanding volume size. Daily use will not require SSH.
  2. The remaining fields in this section can be left as the default. These values are intended to get you started. Depending on how you are utilizing the software and your specific use cases, you may need to increase or decrease. File size and number of files are the largest contributors.
    If you know how much data you are using today, you may consider adjusting your Depot Volume Size to 1.5x your current data usage.

Helix Plan (Formerly Hansoft) Configuration (Optional)

  1. To use the Helix Plan project management tool, select ‘True’
  2. Helix Plan will be deployed to your Azure environment on its own server. We do not recommend adjusting resource defaults for initial setup.

Not sure you will use Helix Plan right away? Deploy now and pause the Helix Plan server until you are ready to start using it. This will reduce your cloud operating costs.

Helix Swarm Configuration (Optional)

  1. To use Helix Swarm — the code review tool for Helix Core — select ‘True’
  2. Helix Swarm will be deployed to your Azure environment on its own server. We do not recommend adjusting resource defaults for initial setup.

Review + Create

Once you have defined all parameters, click on the last tab, Review + create.

Azure will validate your parameters and you will see the message “Validation Passed”.  To initiate your deployment, click the Create button.  We recommend keeping your deployment status page open to aid with post deployment configuration. 

Estimate your monthly expense with the Azure calculator.

Having issues deploying your instance on Azure? Email us >> [email protected]

Find Your Deployment Outputs

After your Perforce deployment is complete, you will be on the Overview tab of your Parent Deployment. Please note the Parent Deployment will be named ‘perforce.perforce-enhanced-studio-pack-##############’, the hashes will be unique to your deployment.


From the sub-navigation of the Parent Deployment, click on Outputs.

You are now located on the Outputs tab of the Parent Deployment. All outputs needed to connect to Helix Core, Helix Swarm, Helix Plan (formerly Hansoft) and the Windows Workstation instances will be located here. 

Microsoft Template

If you navigated away from the deployment progress page you can get to the outputs tab by following these steps:

  1. From your Azure account, search for Resource Groups. Click on Resource Groups.
Microsoft Research
  1. Click on the name of the Resource Group you created for your Perforce deployment. This will be a unique name you defined when filling out the deployment parameters. 
resource groups
  1. From the selected Resource Group sub-navigation menu, select Deployments.
research groups
  1. Here you will see a list of all the Deployments associated with this Resource Group. Scroll to the bottom and click on the Deployment named ‘perforce.perforce-enhanced-studio-pack-#########’, the hashes will be unique to your deployment.
  2. You are now located on the Parent Deployment page. Click on Outputs in the sub-nav.
microsoft azure

Please take note of the following key outputs:

  1. helixCoreInstanceID
  2. p4CommitPublicIP
  3. hansoftPublicIP
  4. swarmPublicIP

These will be used in future sections.

Your Credentials

Refer to section Find Your Deployment Outputs for details on where to find these values.

Helix Core Credentials

Use the following connection details for connecting to Helix Core using Helix Visual Client (P4V) and the Helix Core Command-line (p4 CLI).

Server = ssl:<p4CommitPublicIP>:1666
User = perforce
Password = <helixCoreInstanceID>

<p4CommitPublicIP> and <helixCoreInstanceID> correspond to Azure Deployment outputs found in the Find Your Deployment Outputs section.

Server = ssl:
User = perforce
Password = eee0c937-a98f-4f98-91ee-012432aed840

Access Your Helix Core Server Using Helix Visual Client (P4V)

  1. Download Helix Visual Client (P4V).
  2. Enter in the connection details on the Remote Server tab:
    Server = ssl:<p4CommitPublicIP>:1666
    User = perforce
    Password = <helixCoreInstanceID>
  3. Click OK.
  4. Establish connection by clicking the checkbox “Trust this fingerprint” and click Connect.
  5. In the displayed password prompt, enter the password for the perforce user, which defaults to <HelixCoreInstanceID> output value.
    helix core server
    helix core server
    helix core server
  6. For more information, see the P4V User Guide.

Access Your Helix Core Server Using Helix Sync

  1. Download Helix Sync.
  2. Enter in the connection details:
    Server = ssl:<p4CommitPublicIP>:1666
    Username: perforce
    Password = <helixCoreInstanceID>
  3. Click Connect.
  4. For more information, see the Helix Sync User Guide.
helix synch

Access Your Helix Core Server Using Helix Swarm

  1. Open your browser.
  2. Navigate to http://<SwarmPublicIP>
  3. Login using the following details:
    Username: perforce
    Password: <helixCoreInstanceID>
  4. Click Log in.
  5. For more information, see the Helix Swarm User Guide.

Connect to Helix Plan

  1. Download the Helix Plan client.
  2. Open the Helix Plan Client.
  3. Login using the following details:
  4. Helix Plan Server: <HansoftPublicIP>
  5. Port: 50256
  6. Click Connect.
  7. For more information, see the Helix Plan User Guide.
  8. To connect to the Helix Plan server using the Helix Plan Server Administrator application, no username is required. The password is the output value of <HansoftInstanceID>.

Update Firewall Rules to Allow Additional Users Access

If you have users who will be connecting to Perforce from a different IP address than the one used to deploy the Enhanced Studio Pack, you need to update your firewall rules to grant them access. 

  1. Follow Azure’s instructions on creating a security rule in your network security group.
  2. Input a rule for each user/IP address:
    • Each user will need to provide you with their IP address in IPv4 format.
    • The table below provides the port number for each product the user may need access to:

      ProductService TypePort Number
      Helix CoreTCP1666
      Helix SwarmHTTP80
      Helix Plan (formerly Hansoft)TCP52560

Authenticating to the Helix Core Operating System

Username: rocky
Server: <P4CommitPublicIP>

Example command:
ssh -I /path/to/ssh/private/key [email protected]

Now you are logged in as the rocky user. To perform any Helix Core administration task, switch to the Perforce user, and log into Helix Core with the following commands:

sudo su - perforce
p4login -v 1

You are now logged into Helix Core (P4D) as the perforce user. You have the P4 CLI binaries in your $PATH

To perform OS administration, you can become root with the following command:

sudo -s

Need Support?

Support can be reached by emailing: [email protected]

When emailing support, please include details about your Helix Core server configuration.

  1. Go into Helix Visual Client P4V.
  2. Click Help.
  3. Click System Info.
  4. Copy and paste the contents of System Info into your email to support.



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.