CLion 2018.1 Help

Deployment: Connection Tab

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

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 checkbox to configure the visibility of the server access configuration (deployment configuration).
  • Select the checkbox 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 checkbox is selected in an SFTP configuration, you cannot use your SSH credentials from it when you configure a remote interpreter.
  • When the checkbox is cleared, the configuration is visible in all CLion projects and the settings from, including SSH credentials, can be reused.
See 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 CLion access the server via the FTP file transfer protocol.
  • SFTP: choose this option to have CLion access the server via the SFTP file transfer protocol.
  • FTPS: choose this option to have CLion 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
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 Browse browseButton.png and select the desired folder in the Choose Root Path dialog box that opens.
  • Click the Autodetect button and have CLion 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.
AutodetectClick this button to have CLion 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. FTP, FTPS, SFTP
Log in as anonymousSelect this checkbox 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 or PuTTY) - 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. CLion supports private keys generated using the OpenSSH utility.

  • Authentication agent (ssh-agent or Pageant) - select this option if your SSH keys are managed by a credentials helper application (for example, Pageant on Windows or ssh-agent on Mac and Linux).

See the Generating a new SSH key and adding it to the ssh-agent tutorial for details on working with SSH keys.

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 checkbox to have CLion remember the specified password.FTP, FTPS, SFTP
Save passphraseSelect this checkbox to have CLion 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 CLion 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 CLion, 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 CLion.exe.vmoptions file in the <CLion_installation_folder>/bin and add the following line to it:<path to keystore>
  4. Restart CLion.

Learn more at Java6 and Java7.

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: 24 July 2018

See Also

Language and Framework-Specific Guidelines: