A JBoss Project
Red Hat

Latest posts

Eclipse Mars has arrived, and with it comes a brand new Docker tooling for it.

This blog is a cross-post from Eclipse Newsletter: Landed On MARS where you can read about more things included in recent released Eclipse Mars.


We wanted to have a way to easily start/stop and deploy Docker containers directly from Eclipse.

We wanted something that would run on all three major platforms: Windows, Linux and OS X.

We wanted something that would work together with existing Docker command line tools, but also utilized provide better overview and easier/faster access to common operations, from a visual perspective.

We wanted it to be released with Eclipse Mars.

…​and that is what we got now.

This article runs through how to get it installed, the main features and what the future plans are.

Where do I get it ?

With Eclipse Mars released, you can get it from the Eclipse Mars updatesite, the feature is named Docker Tooling.

If you want to try the latest greatest builds you can use Linux Tools project nightly builds update site at http://download.eclipse.org/linuxtools/updates-docker-nightly/

To use the plugins, it is assumed that Docker is already installed. You can see Docker’s Installation guide on how to do this on various platforms.

Views and Perspectives

Once you have installed the Docker tooling, you will get access to three new views:

Docker Explorer

a tree view listing all connected Docker instances, with image and containers.

Docker Containers

a table view listing containers for selected Docker connection

Docker Images

a table view listing images available in the selected Docker connection

The easiest way to get to see these are by opening the Docker Tooling perspective.

Docker Tooling Perspective

In the screen above, the Docker tooling are connected to a locally running Docker deamon named boot2docker.


To configure this you click the Add Connection…​ button in the Docker Explorer view.

This will start a wizard that will try to detect your default Docker connection setup, dependent on your operating system.

Add Connection Wizard

In Linux it will use standard unix sockets and if on Windows or OSX, it will look for the following environment variables: DOCKER_HOST, DOCKER_TLS_VERIFY and DOCKER_CERT_PATH.

If neither of these are detectable, you can click Use custom connection settings and provide the connection info.

When you have the connection working you can get started using Docker images.

Pull individual images

To pull an image, you use the Pull Image in the Docker Image view.

Pull Image

Here, I’m simply pulling the jboss/wildfly image, a image amongst many available at http://hub.docker.com.


To run the image, the easiest way is to right-click on the image in the Docker Explorer.

Run Image from Docker Explorer

Here, I’ve initially filtered the list to just show images matching wildfly and then using right-click to choose the Run Image…​ action.

Docker Run

From within this dialog you can also search in Docker Hub for other images by clicking Search…​.

Docker search

In this example, I’m only going to focus on running using the defaults, but in the Run Image wizard you can also configure ports, links, volumes, environment variables etc.

By default, we enable interactive and tty mode to allow you to interact with the docker container in the console (i.e. if the image asks for input).

When you click Finish, the container will start and show output in a Console and the Docker Containers view will show which ports are used.


In here, the port at 8080 (the web server) is mapped to 32768 on the docker daemon.

To show this I just need to goto http://dockerhost:32768 to access it. dockerhost is the IP of the docker daemon.



If you have a Dockerfile you can build it via the hammer icon on the Image view. This will start the Build wizard.

docker build

Once built, the image will show up and be possible to use for running.


You can view properties for all the various parts: connection, image and container, including getting a tree view of what docker inspect would show.

docker properties


For Eclipse Mars we added all of the above base features and you can use it in your day-to-day work with Docker.

For Eclipse Mars SR1, we will work on getting some of the rough edges fixed, like 'Run' and 'Build' should be available in the context menu and not only in the views menu.

Work also started in Eclipse CDT to support using Docker images to build binaries for an OS other than the one you are running on. The vision for this would allow running on Windows or Mac, but target native deployment on multiple various Linux architectures.

Furthermore in JBoss Tools we are working on better integrating Docker with Eclipse server adapters, to ease deployment of your web applications to a Docker container. You can see how server deployment works with the current Docker tooling by leveraging docker volumes and remote deployment support.

If you have suggestions or find bugs, please open these in the Linux Tools project under Docker.

Have fun!

Max Rydahl Andersen

I’m happy to announce that from today JBoss Tools 4.3 Beta1 and Developer Studio 9 Beta1 is available for download.

jbosstools jbdevstudio blog header

Java 8 to run Eclipse; older runtimes OK for builds/deployment

To use this Beta, you must run Eclipse with Java 8.

You can still target development for old Java versions though. Yes, you can still target your Java 1.4 projects :)

We are doing this because certain components of Eclipse Mars now require Java 8 (especially Sapphire) and according to our usage stats, Java 8 will have gained majority this year.

But we have not made JBoss Tools dependent on Java 8 yet, since we want to get feedback from users on whether requiring Java 8 will be a problem.

Let us know on our forum, or contact Red Hat support if this will be a problem for you to use it.


JBoss Developer Studio comes with everything pre-bundled in its installer. Simply download it from our JBoss Products page and run it like this:

java -jar jboss-devstudio-<installername>.jar

JBoss Tools or Bring-Your-Own-Eclipse (BYOE) JBoss Developer Studio require a bit more:

This release requires at least Eclipse 4.5 (Mars) but we recommend using the Eclipse 4.5 JEE Bundle since then you get most of the dependencies preinstalled. In case that page it not available check main eclipse download for the Mars release.

Once you have installed Eclipse, you can either find us on the Eclipse Marketplace under "JBoss Tools (Mars)" or "JBoss Developer Studio (Mars)".

For JBoss Tools, you can also use our update site directly if you are up for it.


Note: Integration Stack tooling will become available from JBoss Central at a later date.

What is new ?

The full details of what is new is available on this page. Some highlights below.

New Shiny Central

JBoss Central has now been updated to be faster to load, less overloaded and give access to any project example from developer.jboss.org.

html5 central

Docker tooling

There is now tooling to connect to (multiple) Docker daemons which allows you to pull, build, start, stop, etc. Images and Containers.

docker explorer view

The Docker tooling is technically part of Eclipse Mars, but we wanted to make it easily available to all JBoss Tools users, so we included it into our updatesite. In future releases, we will add some specific JBoss Tools integrations for our server adapters and OpenShift - but for now, what is included are the vanilla Eclipse Mars Docker tools.

Visual Java EE 7 Batch

We’ve added a visual diagram editor for Java EE 7 Batch tooling. Allowing you to visualize and edit your batch flow:


Big thanks to Tomáš Milata who worked on this for his thesis and contributed the foundation for this functionality!

Below is a video of the highlights of the feature set:

OpenShift 3

OpenShift 3 now works with OAuth logins as well as basic authentication and there is now support for creating applications from OpenShift/Kubernetes templates.

create from template

Port Monitoring

JBoss server adapters now support port monitoring, allowing you to trace and inspect requests made to a server.

20150521 monitoring view

Experimental LaunchBar

The Eclipse CDT project created a new feature called the LaunchBar, allowing to easily run launch configurations. We’ve added experimental support for WTP server adapters (like JBoss server adapters) making them as easy to run as a Java app. Details here.

20150604 launchbar

Next steps

Let us know what you like/hate about the release and if you find issues, please open a ticket at our issue tracker.

Going from Beta1 to Beta2, we are focusing on reported issues and going for improving Docker, OpenShift, JavaScript and JavaEE related features.

Hope you enjoy it and remember…​

Have fun!

Max Rydahl Andersen

Looking for older posts ? See the Archived entries.
back to top