Configure an interpreter using SSH

Ensure that there is an SSH server running on a remote host, since PyCharm runs remote interpreters via ssh-sessions.

Do one of the following:

• Click the Python Interpreter selector and choose Add New Interpreter.

• Press Ctrl+Alt+S to open Settings and navigate to Python | Interpreter.

• Click the Python Interpreter selector and choose Interpreter Settings. Click the Add Interpreter link next to the list of the available interpreters.

Click the Add Interpreter link next to the list of available interpreters and select On SSH.

Select an option to create a new SSH connection, then specify server information (host, port, and username).

Alternatively, you can select Existing and choose any available SSH configuration from the list. To create a new SSH configuration, follow the steps below:

Creating an SSH configuration

• Click next to the list of configurations:

  

• Click , disable the Visible only for this project checkbox, and fill in the required fields:

  

• Once done, the newly created SSH configuration will appear in the list of available configurations. It will also become available in the SSH Deployment Configurations settings. Click Next to proceed:

  

In the next dialog window, provide the authentication details to connect to the target server.

Select Password or Key pair (OpenSSH or PuTTY) and enter your password or passphrase. If Key pair (OpenSSH or PuTTY) is selected, specify:

• Private key: location of the file with a private key

• Passphrase: similar to a password, it serves to encrypt the private key.

Click Next to proceed.

Wait until PyCharm completes the introspection of the SSH server.

Generate new or select an existing Python environment.

You can select a virtualenv, conda or uv environment type.