WebStorm 2020.3 Help

Create an in-place server configuration

In the in-place server configuration, the web server is running on your computer, your project is under its document root (for example, in the /htdocs folder), and you do your development directly on the server.

The document root of an in-place server is the parent of the project root, either immediate or not. The document root is the web root or website root directory. Usually, it is the publicly-accessible base folder for a website.

To configure access to the server in this set-up, you only need to specify the URL address of the server document root, appoint the project root folder, and specify the URL address to access it.

In-place server configuration
  1. Open the Deployment page by doing one of the following:

    • In the Settings/Preferences dialog Ctrl+Alt+S, go to Build, Execution, Deployment | Deployment.

    • From the main menu, select Tools | Deployment | Configuration.

  2. The left-hand pane of the Connection tab, that opens, lists all the existing server configurations. Click the Add button and select In-place from the list.

    In the Create new server dialog that opens, type the name of the new server and click OK to return to the Connection tab.

    Configure an inplace server
  3. Specify the URL address of the server document root.

    In the Web server URL field, type the URL address associated with the document root of your Web server as defined in the Web server configuration file. This URL address will be the starting point for building the URL address of your application.

    Both the HTTP and the HTTPS protocols are supported.

    For example, the default document root is set to the htdocs folder, and the default URL address to access the data in it is http://localhost. If you have changed the default port 80, you have to specify the port explicitly: http://localhost:<port>.

    Specify Web server document root URL
  4. Specify the project root folder and the URL address to access it.

    • Open the Mappings tab.

    • In the Local path field, specify the full path to your project root folder. Type the path manually, or click Browse button and select the folder in the dialog, that opens.

    • In the Web path field, type the path to the project root folder relative to the server document root that you specified in your server configuration file.

    Map the project root to it URL
Last modified: 08 March 2021