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
This section outlines some essential steps that must be done before installing Perforce using
Add Trusted Package Repository Keys
The command below does the following.
- Performs a HTTP GET request with no additional verbose logging.
- Outputs the contents of the response to standard output.
- 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).
- Stores the contents of the base64 decoded file into a file path that can then be read by
aptwhen 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.
This section outlines how to install Helix Core CLI (
p4), assuming that you have successfully completed the steps above.
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