PyCharm#

To use remote Python interpreters via SSH in PyCharm, PyCharm Professional is required.

Starting a New Shell#

Start a new shell and obtain its SSH command by running the following:

det shell start --show-ssh-command

For existing shells, use the following:

det shell show_ssh_command <SHELL UUID>

Customizing SSH Commands#

As of the current version, PyCharm lacks support for custom options in SSH commands via the UI.

Therefore, you must provide via an entry in your ssh_config file, typically located at ~/.ssh/config on Linux and macOS systems. The Determined SSH command line follow this pattern:

ssh -o "ProxyCommand=<YOUR PROXY COMMAND>" -o StrictHostKeyChecking=no -tt -o IdentitiesOnly=yes -i <YOUR KEY PATH> -p <YOUR PORT NUMBER> <YOUR USERNAME>@<YOUR SHELL HOSTNAME>

Ensure the following configurations are added to your SSH config:

Host <YOUR SHELL HOSTNAME>
HostName <YOUR SHELL HOSTNAME>
ProxyCommand <YOUR PROXY COMMAND>
StrictHostKeyChecking no
IdentitiesOnly yes
IdentityFile <YOUR KEY PATH>
Port <YOUR PORT NUMBER>
User <YOUR USERNAME>

Setting Up SSH Configuration in PyCharm#

  1. In PyCharm, open Settings/Preferences > Tools > SSH Configurations.

  2. Select the plus icon to add a new configuration.

  3. Enter YOUR HOST NAME, YOUR PORT NUMBER, and YOUR USERNAME in the corresponding fields.

  4. Switch the Authentication type dropdown to OpenSSH config and authentication agent.

  5. Save the new configuration by clicking OK.

Refer to the official PyCharm documentation for setting up a remote interpreter using the new SSH configuration.