Eclipse Remote Development


Very old draft, anticipate inaccuracies and outdated information.


This HOWTO explains how to setup Eclipse for development and debugging on remote servers or virtual machines.

This functionality exists with PyCharm professional, I was looking for ability to use a virtual machine for Python development with Eclipse, rather than force everything through multiple virtualenv’s on my Macbook and Linux desktop.

Although well hidden one of the prebuilt Eclipse packages provides the functionality to do this, but only for C/C++, so after installing the required package, you will have to add the Eclipse plugin(s) to handle your desired language and SCM.

Eclipse recently renamed the PDT package so you should use (1) rather than (2), I am currently using (2).

  1. Eclipse IDE for Scientific Computing

  2. Eclipse for Parallel Application Developers

I suggest you search with Eclipse Marketplace for your plugin, only download and manually install if all else fails.

Color Themes

Eclipse, default color theme kinda sucks unless want to stare at a large white screen all day long! :-D I would strong suggest you install either of:

  1. DevStyle

  2. Eclipse Color Themes

If you recently switched to macOS Mojave and are using Dark mode, use DevStyle, otherwise choose a color theme that works best for you, but note some eclipse plugins don’t work well with certain color themes and the color theme only applies to the editor tabs (unlike DevStyle).

Language Plugin

Now unless you are fortunate and plan to use C/C++ you’ll need to install your desired language and SCM plugins.

Synchronized projects

After installing Eclipse and your required plugins, now let’s create and setup your synchronized project.

Create your synchronized project

Assuming your project already exists on github

$ cd <workspace>
$ git clone <git-url> #<git-user>/<project>.git
$ cd <project>
$ git checkout -b twig-branch

$HOME/workspace # default     # Linux
$HOME/eclipse-workspace       # macOS, if Eclipse was installed using _brew_
C:\Users\%USERNAME%\workspace # Windows

Now we need to convert this to a synchronized project, so


File -> New -> Other -> Synchronized Project


Enter project and select new or existing connection name


Enter connection (brief) details


Enter connection (full) details


Manage your synchronized project


<project> - right mouse click


Manage connections dialogue


Now updates in Eclipse should be automatically synchronized to the remote server in the specified top level directory.

I prefer to work in a remote terminal outside of Eclipse, but it should be able to configure the Eclipse run-time to execute everything on the remote host, but that is left as an exercise for the reader