p4 webserver

Start, stop or show info for the P4 web server.

The P4 web server is a Technology Preview feature introduced with the 2025.2 release of the P4 Server. Features offered in Technology Preview are experimental and not guaranteed to always work as expected. If you have feedback and functionality suggestions, email techpreview@perforce.com.

The REST API runs on the built-in P4 Web Server, which must be started before you can use the API. To learn more, see p4 webserver in the P4 CLI Documentation.

The web server provides REST API endpoints only. It does not provide a browser-based user interface, and accessing the root URL (/) will return a 404 response.

To learn more about using the REST API, see the P4 REST API documentation.

Syntax

p4  webserver start -p [ip:]port
p4  webserver start tcp:[ip:]port
p4  webserver stop -p [ip:]port
p4  webserver show

Syntax and naming conventions

Description

Starts or stops the P4 web server.

If the P4 Server is configured with an SSL certificate, the web server automatically starts in HTTPS mode using the same certificate. This means HTTPS can be enabled even if it is not explicitly configured for the web server.

To force the web server to use HTTP instead of HTTPS, specify the tcp: prefix when configuring the web server port. For example:

p4 webserver start tcp:0.0.0.0:8080

p4 webserver show displays the current configuration and runtime information for the P4 web server, including its listen address, protocol (HTTP/HTTPS), status, and any active settings that were applied at startup.

For example, p4 webserver show outputs:

Web server status: running
Listen address: tcp:0.0.0.0:8080
Protocol: HTTP
Document root: /p4root/htdocs

Options

Option Description

Option	Description
`-p [ip:]port`	Enter the port of the web server to start or stop. The inclusion of the IP address is optional.
`tcp:[ip:]port`	Use this option to to force the server to start in HTTP mode, even when the P4 Server is configured to use SSL Enter the port of the web server to start or stop. The inclusion of the IP address is optional.
`show`	Outputs the current configuration and runtime information for the P4 web server

-p [ip:]port

Enter the port of the web server to start or stop. The inclusion of the IP address is optional.

tcp:[ip:]port

Use this option to to force the server to start in HTTP mode, even when the P4 Server is configured to use SSL

Enter the port of the web server to start or stop. The inclusion of the IP address is optional.

show Outputs the current configuration and runtime information for the P4 web server

Usage notes

Can file arguments use revision specifier? Can file arguments use revision range? Minimal access level required

Can file arguments use revision specifier?	Can file arguments use revision range?	Minimal access level required
N/A	N/A	`super` available to an operator user

N/A

super

available to an operator user

This command can be run at the command line or used as a startup command in a server specification. To learn more, see Server startup commands in the P4 Server Administration Documentation.