IntelliJ IDEA 2017.2 Help

Deployment: Connection Tab

Use this tab to choose the way to access the Web server and specify the connection settings.

ItemDescription
Name The text box shows the configuration name specified in the Add Server dialog box. Edit the configuration name, if necessary.
Visible only for this project Use this check box to configure the visibility of the server access configuration (deployment configuration).
  • Select the check box to restrict the use of the configuration to the current project. Such configurations cannot be reused outside the current project, they do not appear in the list of available configurations in other projects. For example, if this check box is selected in an SFTP configuration, you cannot use your SSH credentials from it when you configure a remote interpreter.
  • When the check box is cleared, the configuration is visible in all IntelliJ IDEA projects and the settings from, including SSH credentials, can be reused.
See Configuring Node.js Interpreters and Configuring Remote PHP Interpreters for details.
Access type From this drop-down list, choose the way to access the server. Use the Up and Down keyboard keys to scroll through the list of server configuration types. The available options are:
  • FTP: choose this option to have IntelliJ IDEA access the server via the FTP file transfer protocol.
  • SFTP: choose this option to have IntelliJ IDEA access the server via the SFTP file transfer protocol.
  • FTPS: choose this option to have IntelliJ IDEA access the server via the FTP file transfer protocol over SSL (the FTPS extension).
  • Local or mounted folder: choose this option if the Web server is running in a local or a mounted folder and its document root is NOT the parent of the project root.
  • In-place: choose this option if the Web server is running on your computer, your project is under its document root, and you do your development directly on the server.

Upload/Download Project Files

In this area, specify the settings for accessing the server to upload and download files to and from.

The set of controls in the area depends on the chosen server access type.

ItemDescriptionAvailable for
FolderIn this field, specify the server configuration root.

The server configuration root is the highest folder in the file tree on the server that can be accessed through the server configuration. The easiest way is to use the document root of your Web server as defined in the Web server configuration file. However you can appoint any other existing folder under the document root.

Local or mounted folder
FTP/FTPS/SFTP hostIn this text box, specify the host name of the FTP/SFTP server to upload the files to.FTP, FTPS, SFTP
PortIn this text box, specify the port to use. The default values are:
  • 21 for FTP and FTPS
  • 22 for SFTP
FTP, FTPS, SFTP
Root Path In this text box, specify the server configuration root relative to your user home which was defined when you registered your account. This folder will be the highest one in the folder structure accessible through the current server configuration. Do one of the following:
  • Accept the default value /, which points at the user home folder on the server.
  • Type the path manually.
  • Click the Browse button browseButton.png and select the desired folder in the Choose Root Path dialog box that opens.
  • Click the Autodetect button and have IntelliJ IDEA detect the user home folder settings on the FTP/SFTP server and set up the root path according to them. The button is only enabled when you have specified your user name and password.
FTP, FTPS, SFTP
AutodetectClick this button to have IntelliJ IDEA detect the user home folder settings on the FTP/SFTP server and set up the root path according to them.FTP, FTPS, SFTP
User name In this text box, type your user name for authentication to the server.

The button is only enabled when you have specified your user credentials.

FTP, FTPS, SFTP
Log in as anonymousSelect this check box to enable anonymous access to the server with your email address as password.FTP, FTPS, SFTP
Auth type From this drop-down list, select the client authentication method. The available options are:
  • Password - select this option to use standard authentication through a password.
  • Key pair (OpenSSH) - select this option to use SSH authentication via a key pair.

    To apply this authentication method, you need to have your private key on the client machine and your public key on the remote server you connect to. IntelliJ IDEA supports private keys generated using the OpenSSH utility. See http://wiki.qnap.com/wiki/How_To_Set_Up_Authorized_Keys for details.

SFTP
PasswordIn this text box, type your password for authentication to the server.FTP, FTPS, SFTP
Private key fileIn this text box, specify the location of your private key file.SFTP
PassphraseIn this text box, specify your authentication passphrase.SFTP
Save passwordSelect this check box to have IntelliJ IDEA remember the specified password.FTP, FTPS, SFTP
Save passphraseSelect this check box to have IntelliJ IDEA remember the specified passphrase.SFTP
Test FTP/FTPS/SFTP connectionClick this button to check that the specified settings ensure successful connection via FTP/SFTP.FTP, FTPS, SFTP
Explicit Choose this option to have the explicit (active) security applied. Immediately after establishing connection, the FTP client on your machine sends a command to the server to establish secure control connection through the default FTP port. FTPS
Implicit Choose this option to have the implicit (passive) security applied. In this case, security is provided automatically upon establishing connection to the server which appoints a separate port for secure connections. FTPS
Advanced options Click this button to specify additional uploading settings in the Advanced Options dialog box that opens. FTP, FTPS, SFTP
Web server root URL In this text box, specify the URL address of the Web server root folder. Both the HTTP and the HTTPS protocols are supported.

To access a server through HTTPS, you need to acquire a certificate file <certificate_name>.cert signed by a recognized authority and import this certificate in the truststore/keystore of the Oracle JRE (Java Runtime Environment) on which IntelliJ IDEA runs. Note that self-signed certificates are rejected as unsafe.

To import a certificate in Oracle JRE:

  1. Open the embedded Terminal and type the following command:
    <jre_home>/bin/keytool.exe -importcert -keystore <path to jre truststore/keystore> -file <full_path_to_<cert_name>.cert>
    If you are using the Oracle JRE bundled with IntelliJ IDEA, the default path to the truststore/keystore is <%product_installation_folder>/jre/jre/lib/security/jssecacerts or <%product_installation_folder>/jre/jre/lib/security/cacerts.

    Otherwise it is <jre_home>/jre/lib/security/jssecacerts or <jre_home>/jre/lib/security/cacerts.

  2. When asked to enter a password for the truststore/keystore, specify the default one changeit.
  3. Open the IntelliJ IDEA.exe.vmoptions file in the <IntelliJ IDEA_installation_folder>/bin and add the following line to it:
    -Djavax.net.ssl.keyStore=<path to keystore>
  4. Restart IntelliJ IDEA.

Learn more at Java6 and Java7.

All
OpenClick this button to make sure that the specified server root URL address is accessible and points at the correct Web page.All
Last modified: 29 November 2017

See Also

Language and Framework-Specific Guidelines: