Please note that these documents apply to OpenShift Online v2 only (accounts created before August 1st, 2016).
If you are using one of the OpenShift 3 products, please refer to documents available at

Installing JBoss Developer Studio

Installing the JBoss Developer Studio executable .jar file requires you already have Java installed for your platform. What follows is a step by step guide for walking through the JBoss Developer Studio installation wizard.

In order to verify that the currently installed Java supports the JBoss Developer Studio version you are about to install, please visit the JBoss website, where you can find a link to documentation describing what Java version is required. For example, the JBoss Developer Studio 9.1.0 can be installed using an older version of Java, but it requires Java 8 to run.

Starting the Installer

After downloading the installer .jar file you need to start the installer. This can be slightly different depending on which platform you are running and what version of Java you have installed.


In Windows File Explorer open the folder you downloaded the installer to. You may be able to double-click on the file to get it to run but if this does not work you can follow these steps:

Right click on the file and select Open with…​ from the context menu

JBoss DS Windows Step 1

Select Java from the dialog that pops up:

JBoss DS Windows Step 2

Mac OS X

Apple Java should already be installed on your system. In the finder simply open up the folder you downloaded the installer to and double click on the file to start the installer.


From the terminal, run this command:

java -jar <path to installer>

Stepping Through the Installation Wizard

The following steps are the same for all platforms.

Step 1

You will be greeted by an Introduction page. Click the Next button to continue:

JBossDS Setup Step 1

Step 2

On the license page you must acknowledge that you accept the terms of the license agreement by clicking on the radio button. Click the Next button to continue.

JBossDS Setup Step 2

Step 3

On this page you can select a directory you wish to install the program files to. It is safe to just select the default by clicking on the Next button to continue.

JBossDS Setup Step 3

Step 4

You may select a different Java to run under if you have multiple versions installed. In most cases you just want to select the default by clicking on the Next button to continue.

JBossDS Setup Step 4

Step 5

The Select Platform and Servers page is for advanced configuration. It is safe to just ignore this and click on the Next button to continue.

JBossDS Setup Step 5

Step 6

On the Summary page you can review your settings and check to make sure you have enough disk space to install. Click the Next button to continue.

JBossDS Setup Step 6

Step 7

The installation step will take a few minutes installing the files. Once it is done the →Next button will reappear and you can click on it to continue to the next step.

JBossDS Setup Step 7

Step 8

Here you can have the installer add shortcuts to your desktop or start menu. Make sure you select at least one of these so that you can launch the application when you want to use it. Click the Next button to go to the last step.

JBossDS Setup Step 8

Step 9

The last step will display some information you might want to take note of. Once you are finished you can click on the Done button to close the installer and run the JBoss Developer Studio.

JBossDS Setup Step 9

The JBoss Developer Studio is launched by now. Since the OpenShift plugin comes with the Developer Studio you will notice an OpenShift link on the start page which is a great starting point for creating an OpenShift application.

JBossDS Launched