Step 1: Download and install P4V | End user
To version files and collaborate with your team, you will primarily use the Helix Core Visual Client, also known as P4V. P4V is available for Windows, macOS, and Linux.
Before installing P4V, your Helix Core administrator should provide you with the Helix Core Server connection information and credentials. If you need this information, contact your administrator.
Download the P4V installer
-
Go to the P4V download page.
-
In the Family field, select your operating system. If you are downloading the Windows installer, in the Version field, select (EXE).
-
Click Download.
-
In the download confirmation dialog box, click Download again.
-
After the download is complete, install P4V using the steps for your operating system.
Install P4V and P4Merge
Windows
-
Double-click the downloaded .exe file to start the installer.
-
On the Select Applications screen, select Helix Visual Client (P4V) and Merge and Diff Tool (P4Merge). To install P4V in a different directory, click Change and select a folder.
You can also choose to install the Command-Line Client (P4).
-
Click Next.
- On the Client Configuration screen, enter or select the following information:
Server: Enter the Helix Core Server address provided by your administrator.
User name: Enter your username provided by your administrator.
Text Editing Application: Accept the default editor or click Browse to select a different application.
-
Click Next.
-
On the Ready to install screen, click Install to start installation.
If prompted to allow the installer to change your computer, click Yes.
-
When the installation is complete, on the Finished installing screen, click Exit.
-
In the Open Connection dialog box, verify that the server and username are correct, and then click OK.
-
In the Perforce Password Required dialog box, enter your password and click OK.
P4V opens.
macOS
-
Double-click the downloaded .dmg file.
-
Drag p4v and p4merge to the Applications folder.
-
In the Applications folder, double-click p4v. If you are prompted to open it, click Open.
-
In the Open Connection dialog box, enter the following information:
-
Server: Address provided by your administrator.
-
User Name: Username provided by your administrator.
-
-
Click OK.
-
In the Perforce Password Required dialog box, enter your password and click OK.
P4V opens.
If you want to use the command-line client (P4), you must download and install it separately.
Linux
For Linux platforms, P4V is packaged in a compressed .tgz file.
-
Uncompress the .tgz file.
New directories are created:
-
p4v-202x.xxxxxx/bin
-
p4v-202x.xxxxxx/lib
-
-
Add the new directories to your PATH. For example:
PATH="$PATH:~/Downloads/p4v-2024.1.2591061/bin:~/Downloads/p4v-2024.1.2591061/lib
-
To start P4V, open a terminal window and type p4v.
P4V opens.
If you want to use the command-line client (P4), you must download and install it separately.
Command-line client (P4) download and installation - macOS and Linux only
P4 is the command-line client for Helix Core. If you are using macOS or Linux, install P4. P4 is automatically installed during P4V Windows installation.
-
Go to the P4 download page.
-
In the Family field, select your operating system.
-
In the Platform field, select the platform to install on.
-
Click Download.
-
After the download completes, extract the archive.
On macOS, double-click the archive (.tgz file) and a folder with the same name is created. Then, copy the file named p4 into the /usr/local/bin folder. To do this, open another Finder window, choose Go > Go To Folder, type /usr/local/bin, and press Enter. Drag the P4 app from where you extracted it to the /usr/local/bin folder. When prompted, enter your admin password or other required authentication.
-
To test that P4 works correctly, at a command prompt, type p4 info. Installation is successful unless a Command not found: p4 error is displayed.
A client error may be displayed that tells you to check $P4PORT. P4PORT stores the server address you entered during P4V installation and P4USER is the username you entered. To view your default P4 settings, at a command prompt, type p4 set.
What's next
Next, change your password.
Go to Step 2: Change your password.