CLion 2020.2 Help

SSH Configurations

File | Settings | Tools | SSH Configurations for Windows and Linux

CLion | Preferences | Tools | SSH Configurations for macOS Ctrl+Alt+S the Settings/Preferences icon

Use this page to set up SSH configurations, which can be then used in remote and WSL toolchains, and in Remote GDB Server run/debug configurations.


ItemTooltip and ShortcutDescription
the Add button



Click this button to create a new SSH configuration.
the Remove button



Click this button to remove the selected SSH configuration from the list.

SSH Connection parameters

Visible only for this project

Use this checkbox to configure the visibility of the SSH configuration.

  • Select the checkbox to restrict the use of the SSH configuration to the current project. Such SSH configuration cannot be reused outside the current project. It does not appear in the list of available configurations in other projects.

    The SSH configurations are stored in the .idea directory together with the project, which allows sharing them between team members through a VCS.

  • When the checkbox is cleared, the SSH configuration is visible in all CLion projects. Its settings can be reused across several projects.

HostIn this field, specify the host name of the server to connect to.
User name In this field, type your username for authentication to the server.
Port In this field, specify the remote port to connect to. The default value is 22.
Local port

In this field, specify the outgoing port to use. The default value is <Dynamic>, and the port is selected automatically.

Authentication type

From this list, select the client authentication method. The available options are:

  • Password: select this option to use standard authentication through a password.

    • Password: in this field, type your password for authentication to the server.

    • Save password: select this checkbox to have CLion remember the specified password.

  • Key pair (OpenSSH or PuTTY): select this option to use SSH authentication via a key pair.

    To apply this authentication method, you must have a private key on the client machine and a public key on the remote server. CLion supports private keys that are generated with the OpenSSH utility.

    • Private key file: in this field, specify the location of your private key file.

    • Passphrase: in this field, specify your authentication passphrase.

    • Save passphrase: select this checkbox to have CLion remember the specified passphrase.

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

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

Test connectionClick this button to check that the specified settings ensure successful connection. The button is only enabled when you have specified your user credentials.
Last modified: 25 September 2020