Creating an In-Place Server Configuration
The functionality described on this page and in the whole Working with Web Servers: Copying Files chapter is available only in the Ultimate Edition of IntelliJ IDEA.
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 (for example, in the /htdocs folder), 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.
Specify the name, type, and visibility of a server configuration
Open the Deployment page by doing one of the following:
In the Settings/Preferences dialog (Ctrl+Alt+S), select Deployment under Build, Execution, Deployment.
Chooseon the main menu.
In the left-hand pane that lists all the existing server configurations, click Add and select In-place from the list.
Click the Use as Default toolbar button to have IntelliJ IDEA silently apply the current configuration in the following cases:
Use the Visible only for this project checkbox to configure the visibility of the server access configuration.
Select the checkbox to restrict the use of the configuration to the current project. Such configuration cannot be reused outside the current project. It does not appear in the list of available configurations in other projects.
The server records are stored in the .idea directory together with the project, which allows sharing them between team members through a VCS.
In the server access configurations list in the left-hand pane, the configurations visible only in the current project are marked with the icon.
When the checkbox is cleared, the configuration is visible in all IntelliJ IDEA projects. Its settings, including SSH credentials for SFTP servers, can be reused across several projects.
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 the project root folder and the URL address to access it
Switch to the Mappings tab.
In the Local path field, specify the full path to your project root folder. Type the path manually, or click and choose 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 specified in the server configuration file.