PyCharm 3.1.0 Web Help

Some features described here are available in Professional edition only.

In this section:

Prerequisites

  • 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 an in-Place Server Configuration.

To configure a remote Python interpreter
  1. In the Python Interpreters page of the project settings, click add .
  2. In the drop-down list, choose Remote.

    py_remote_interpreter_choose

    The dialog box Configure Remote Python Interpreter opens:

    py_configure_remote_interpreter

  3. In the Configure Remote Python Interpreter dialog box, do one of the following:
    • Click the button Fill from deployment server settings. So doing, the remote server settings are taken from one of the servers which have already been configured, as described in the section Creating an in-Place Server Configuration.

      Note

      The button Fill from deployment server settings appears in the dialog box if at least one remote server has been configured in advance on the Deployment page of the Settings dialog.

    • In the Settings area, fill in the server information manually (host, port, etc.).
  4. The Python interpreter path field displays the path to the desired Python executable. You can accept default, or specify a different one.
  5. Click OK in the Configure Remote Python Interpreter dialog box. The configured remote interpreter is added to the list.

Important notes

Note

When a remote Python interpreter is added, at first the PyCharm helpers are copied to the remote host. PyCharm helpers are needed to run remotely the packaging tasks, debugger, tests and other PyCharm features. Next, the skeletons for binary libraries are generated and copied locally. Also all the Python library sources are collected from the Python paths on a remote host and copied locally along with the generated skeletons. Storing skeletons and all Python library sources locally is required for resolve and completion to work correctly in PyCharm.

PyCharm checks remote helpers version on every remote run, so if you update your PyCharm version, the new helpers will be uploaded automatically and you don't need to recreate remote interpreter.

SFTP support is required for copying helpers to the server.

See Also

Reference:

External Links:

Web Resources: