PyCharm 2017.3 Help

Configuring Remote Interpreters via SSH

This feature is only supported in the Professional edition.

The following is only valid when SSH Remote Run Plugin is installed and enabled!


  • A ssh server should run on a remote host, since PyCharm runs remote interpreter via ssh-session.
  • If you want to copy your sources to a remote computer, create a deployment configuration, as described in the section Creating a Remote Server Configuration.

Configuring remote Python interpreter via SSH credentials

To configure a remote Python interpreter via SSH credentials

  1. In the Project Interpreter page of the Settings/Preferences dialog box, click cogwheel framed.
  2. From the drop-down list, choose Add Remote.
    py remote interpreter choose

    The dialog box Configure Remote Python Interpreter opens.

  3. In the dialog box Configure Remote Python Interpreter, click the radio-button SSH credentials:
    py configure remote interpreter
  4. In the Configure Remote Python Interpreter dialog box, fill in the server information (host, port, etc.)

    Note the Auth type field. It suggests the following options: Password, Key pair and Authentication agent. If you choose one of the first two options, you should have to enter your password or passphrase. However, the last option allows you to use the authentication agents ssh-agent or Pageant.

  5. The Python interpreter path field displays the path to the desired Python executable. You can accept default, or specify a different one.
  6. Click OK in the Configure Remote Python Interpreter dialog box. The configured remote interpreter is added to the list.
  7. Back in the Project Interpreter page, if necessary, configure the path mappings:
    1. Click browseButton:
      py edit path mapping
    2. In the dialog box that opens add (add) or delete (delete) path mappings as desired.
Last modified: 28 March 2018

See Also