Perforce Software
How to Use P4Web

Note: Please read the Release Notes.

How P4Web Works · How to Install P4Web · How to Start P4Web · The 'p4web' Command
Connecting to P4Web · How to Stop P4Web · User Documentation

How P4Web Works

P4Web is Perforce client program that runs on any platform. It can be used either as a private Helper or as a public Viewer:

P4Web communicates with the Perforce server using the Perforce C++ API. It also communicates with your web browser, sending HTML and receiving URL requests and form input. To your web browser, P4Web looks very much like a web server. To a Perforce server, P4Web looks like any other Perforce client program.

How to Install P4Web

P4Web is available for Macintosh, Windows, and Unix. For download information, please go to the Perforce Downloads page.

How to Start P4Web

Before you can point your browser to it, the P4Web program must be up and running.

On Macintosh, double-click P4Web to start it up. To configure P4Web on a Mac, hold down the option-key as it starts up. You will be presented with a configuration dialog box.

On Windows, you can start the P4Web you configured during installation by clicking Start->Programs->Perforce->P4Web. You can also start a P4Web with an alternate configuration using the p4web command, as described below. Run p4web in the Start->Run window or with the p4web command in a Command Prompt window.

On Unix you can start the P4Web program with p4web command, as described below.

The 'p4web' Command

Run the p4web command to start a P4Web program from a command shell. When P4Web starts up, it displays information about the Perforce user, client, and server port it's using, and the URL your browser should use to connect to it. The p4web command syntax is:

p4web [-w port] [-b or -B] [-l] [global_options] [-h] [-V]

Connecting to P4Web

Once you've started a P4Web Helper or Viewer you can connect to it with your Web browser. Point your browser to:

http://localhost:nnnn/

where nnnn is your P4Web's port address. (If your browser is running on a different machine than P4Web, use the name of the machine P4Web is running on instead of "localhost".) Enter your Perforce username and password at your browser's prompt to begin using P4Web.

How to Stop P4Web

To stop a P4Web program running on...

User Documentation

Once you've pointed your browser to P4Web you can use its Help links to access P4Web user documentation. You can also access the same documentation on our web site via these links:


Copyright 2003 Perforce Software. All rights reserved.
$Id: //depot/live/www/perforce/doc.031/manuals/p4web/index.html#2 $