Connecting to the Perforce server

The first time you launch P4V, the Connection Setup Wizard (Macintosh: Connection Setup Assistant) runs automatically. You can use the wizard to specify connection settings and create a user and workspace if required. In subsequent P4V sessions, the Open Connection dialog is displayed by default. To run the wizard/assistant manually, choose Connection > Set Up Connection...

To connect to a Perforce server: If you have previously used the connection, choose Connection>Open Recent and select the desired settings. Otherwise:

  1. Choose Connection>Open Connection... The Open Connection dialog is displayed.
  2. Enter the server name and port number for this connection using server_host:port_number syntax.
    Note: You can browse for servers if your computer and the server have Zeroconf software (such as Bonjour or Avahi) installed and your Perforce administrator has configured Perforce servers to advertise as Zeroconf services. To list available servers, click Browse... button.
  3. In the User field, enter your user name.
  4. (Optional) In the Workspace field, specify the name of your client workspace.
  5. Click OK.

P4V connects to the specified Perforce server and displays a new instance of its main window.

(Windows only) You can set Windows environment variables for Perforce connection settings, which makes the settings available to other Perforce client applications (for example, P4EXP, the Perforce plug-in for Windows Explorer).

To set connection-related environment variables, choose Connection > Environment Settings... and specify the desired settings.

To configure P4V to use environment connection settings at startup, choose Edit > Preferences... and, on the Connections tab, enable Open the connection that matches your Perforce environment settings.

Favorite Connections

You can maintain a list of favorite connections and assign descriptive names to the entries, to free you from having to remember port numbers and server host names.