Luc Shelton

In this article I will outline in clear simple steps what is required for installing command-line tooling for Perforce on Ubuntu. These instructions are for those who are wish to install it using APT (apt install etc.), instead of manually installing it themselves by downloading and copying the binaries from the official website to your system's /usr/bin/local directory. This method guarantees that you will always receive updates for as long as you have your apt configured to source the Perforce repository.

#!/bin/bash
apt update && apt upgrade -y

Configuration

This section outlines some essential steps that must be done before installing Perforce using apt.

Add Trusted Package Repository Keys

The command below does the following.

1. Performs a HTTP GET request with no additional verbose logging.
2. Outputs the contents of the response to standard output.
3. Pipes the content of standard output to gpg, a tool used for encryption, and decodes the file which is typically encoded in base64 (making it transmittable as text).
4. Stores the contents of the base64 decoded file into a file path that can then be read by apt when searching for packages from the Perforce repository (read next).

#!/bin/bash
wget -qO - https://package.perforce.com/perforce.pubkey | sudo gpg --dearmor -o /usr/share/keyrings/perforce-archive-keyring.gpg

Add Repository Source

This section outlines steps required for adding the Perforce repository as an installable source.

The following commands need to be executed so that apt will be able to pull package information from the official Perforce package repository. You'll note that it references the public key that we downloaded in the previous section; this is used for verifying that packages installed from this source are signed with this key-pair.

#!/bin/bash
echo "deb [signed-by=/usr/share/keyrings/perforce-archive-keyring.gpg] http://package.perforce.com/apt/ubuntu  $(lsb_release -c -s) release" | sudo tee /etc/apt/sources.list.d/perforce.list
sudo apt update

At this point, helix-cli should now be available as an installable package from the Perforce repository. You can check whether the new package repository source is available by running the following command.

Resulting output from running the command "apt search", providing that you have followed the steps correctly.

Installation

This section outlines how to install Helix Core CLI (p4), assuming that you have successfully completed the steps above.

Installing helix-cli is as simple as running the following command.

#!/bin/bash
apt install helix-cli

If everything installed correctly, you should now be able to use the p4 command from the terminal. You can check if it is correctly installed simply by running the command "p4", or by running the following command instead.

#!/bin/bash
command -v p4

The resulting output should be the absolute path to where the command is made available from in the $PATH environment variable.

If you wish to be even more pedantic, you can run the following command which should display the status of the newly installed package.

#!/bin/bash
dpkg -l helix-cli

That's it.