Creating an In-Place Server Configuration
An in-place server is a server whose document root is the parent of the project root, either immediate or not. In other words, the Web server is running on your computer, your project is under its document root, and you do your development directly on the server.
To configure access to the server in this set-up, you only need to specify the URL address of the sever document root, appoint the project root folder, and specify the URL address to access it.
On this page:
- Creating a server configuration, specifying its name and type
- Configuring access to an in-place server: specifying the URL address of the server document root
- Specifying the project root folder and the URL address to access it
Creating a server configuration, specifying its name and type
Open the Deployment dialog box. Do one of the following:
- Open the Settings dialog box ( ), and then click Deployment.
- Choose on the main menu.
- In the left-hand pane, that shows a list of all the existing server configurations, click the Add toolbar button . The Add Server dialog box opens.
- Specify the server configuration name in the Name text box. From the Type drop-down list, choose the server configuration type In-place.
- Click OK. The Add Server dialog box closes and you return to the Connection tab of the Deployment dialog box.
Configuring access to an in-place server: specifying the URL address of the server document root
In the Web server root URL text box, 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.
To access a server through HTTPS, you need to acquire a certificate file
<certificate_name>.certsigned by a recognized authority and import this certificate in the truststore/keystore of the Oracle JRE (Java Runtime Environment) on which WebStorm runs. Note that self-signed certificates are rejected as unsafe.
To import a certificate in Oracle JRE:
Open the embedded Terminal and type the following command:
If you are using the Oracle JRE bundled with WebStorm, the default path to the truststore/keystore is
<jre_home>/bin/keytool.exe -importcert -keystore <path to jre truststore/keystore> -file <full_path_to_<cert_name>.cert>
Otherwise it is
When asked to enter a password for the truststore/keystore, specify the default one
WebStorm.exe.vmoptionsfile in the
<WebStorm_installation_folder>/binand add the following line to it:
-Djavax.net.ssl.keyStore=<path to keystore>
- Restart WebStorm.
For example, the Apache httpd server configuration file is
httpd.conf. The default document root is the
htdocsfolder 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:
- Open the embedded Terminal and type the following command:
Specifying the project root folder and the URL address to access it
- Switch to the Mappings tab.
- In the Local path text box, specify the full path to your project root folder. Type the path manually, or click the Browse button and choose the folder in the dialog box, that opens.
- In the Web path on server text box, type the path to the project root folder relative to the server document root specified in the server configuration file. As you type, WebStorm dynamically builds the URL address through which your project root folder will be accessible and shows it as a link in the Project URL read-only field. To check that the URL address is constructed correctly and ensures access to the project root, click the link.