Installation

This topic assumes you have read Linux package-based installation, including its 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.

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 instructions at Perforce Packages.

  1. Follow the instructions at Perforce Packages.

    • For APT (Ubuntu), see "How to Configure APT repositories".
    • For YUM (Red Hat Enterprise Linux or CentOS), see "How to Configure YUM repositories".
    • For SUSE Linux Enterprise Server, see "How to Configure YUM repositories". You might want to use the zypper equivalent to yum.
  2. Install the helix-p4d package by running the command for your operating system.

    For Ubuntu:

    $ sudo apt-get install helix-p4d

    For CentOS or Red Hat Enterprise Linux:

    $ sudo yum install helix-p4d

    For SUSE Linux Enterprise Server:

    $ sudo zypper install helix-4d
  3. Follow the prompts.

  4. See Post-installation configuration.