Installation

This topic assumes you have met the Prerequisites.

The Helix Server is divided into multiple packages, so you can install the components you need. The component package names are:

  • helix-p4d
  • helix-p4dctl
  • helix-proxy
  • helix-broker
  • helix-cli

The helix-p4d package installs the main component of a Perforce service, p4d, as well as the command line interface (p4, which is distributed as helix-cli), the service controller (p4dctl), and a configuration script to set them up.

At minimum, you need to install the helix-p4d package. To install a different package, substitute its name for helix-p4d in the commands below.

Package installation requires sudo or root level privileges.

Verify the Public Key

Important

14 August 2023 is the expiration date of the Perforce packaging key, but this key has been renewed until 11 June 2026 UTC. Package managers do not allow installation with an expired key. To ensure you have the renewed key, follow the steps below.

To ensure you have the correct public key for installing Perforce packages, download the key and verify the fingerprint of the Perforce public key against the fingerprint shown below.

  1. Download the public key at https://package.perforce.com/perforce.pubkey
  2. To obtain the fingerprint of the public key:
    • For Ubuntu 14.04/16.04 & RHEL/CentOS 6/7: gpg --with-fingerprint perforce.pubkey
    • For Ubuntu 18.04/20.04/22.04 and RHEL/CentOS 8/9: gpg -n --import --import-options import-show perforce.pubkey
  3. Verify that it matches this fingerprint:

E581 31C0 AEA7 B082 C6DC 4C93 7123 CB76 0FF1 8869

Follow the instructions that apply to you:

For APT (Ubuntu)

1. Add the Perforce packaging key to your APT keyring:

wget -qO - https://package.perforce.com/perforce.pubkey | gpg --dearmor | sudo tee /usr/share/keyrings/perforce.gpg

  • If you are required to use an older OS that does not support the above method, you can use:

wget -qO - https://package.perforce.com/perforce.pubkey | sudo apt-key add -

  • If you are required to use an older version of OpenSSL that does not support TLSv1.2 or higher, replace https with http in the wget command.

2. Add Perforce's repository to your APT configuration:

Create a file called /etc/apt/sources.list.d/perforce.list with the following line:

deb [signed-by=/usr/share/keyrings/perforce.gpg] https://package.perforce.com/apt/{os} {distro} release

Where {os} is replaced with ubuntu, and {distro} is replaced by one of the supported distributions at https://package.perforce.com/apt/ubuntu/dists/

Not all products are available on all combinations of os and distro.
3. Run apt-get update

You can now search for and install Helix Core packages using your preferred package management tool.

You can also browse the repository and download a Deb file directly from https://package.perforce.com/apt/

See Post-installation configuration.

For YUM (Red Hat Enterprise Linux or CentOS)

  1. Add Perforce's packaging key to your RPM keyring:

    sudo rpm --import https://package.perforce.com/perforce.pubkey

  2. Add Perforce's repository to your YUM configuration.

    Create a file called /etc/yum.repos.d/perforce.repo with the following content:

    [perforce]
    name=Perforce
    baseurl=http://package.perforce.com/yum/rhel/{version}/x86_64
    enabled=1
    gpgcheck=1

    where the RHEL/CentOS {version} is 6, 7, 8, or 9

  3. Install the package by running sudo yum install helix-p4d

See Post-installation configuration.

For SUSE Linux Enterprise Server

  1. Add Perforce's packaging key to your RPM keyring:

    sudo rpm --import http://package.perforce.com/perforce.pubkey

  2. Add the Perforce repository.

    sudo zypper addrepo http://package.perforce.com/yum/rhel/7/x86_64/ helix

  3. Install the package by running sudo zypper install helix-p4d

See Post-installation configuration.