Proactive insights, news and tips from Oracle WebLogic Server Support. Learn Oracle from Oracle.

WebLogic Server in Eclipse IDE for Java EE Developers

Stephen Felts

This article describes how to integrate WebLogic Server in the latest supported version of Eclipse IDE for Java EE Developers.

You need to start by getting all of the pieces - Java SE Development Kit, WebLogic Server, and Eclipse IDE.

Go to http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html to download Java SE Development kit (neither WLS nor Eclipse come with it).  Accept the license agreement, download the binary file, and install it on your computer.  Set your JAVA_HOME to the installation directory and add $JAVA_HOME/bin to your PATH.

Next get and install a copy of WebLogic Server (WLS).  The latest version of WLS that is currently supported in Eclipse is WLS The standard WLS download page at http://www.oracle.com/technetwork/middleware/weblogic/downloads/wls-main-097127.html  has at the top.  If you are running on Windows, your command window to run the jar command will need to be running as the Administrator. 

unzip fmw_12.

java -jar fmw_12.

You can take all of the default values.  You will need to specify an installation directory.  You might want to install the examples.  On the last page, make sure the “Automatically Launch the Quickstart Configuration Wizard” is clicked to create the domain. 

In the Configuration Wizard, take the defaults, you may want to change the domain directory, enter a password, and click on Create.

Download “Eclipse IDE for Java EE Developers” from http://www.eclipse.org/downloads/eclipse-packages/ and unzip it.  The latest version that OEPE supports is Oxygen.3 (it's not currently running correctly on 2018-12-R or later). 

Change to the Eclipse installation directory and run eclipse.

Select a directory as a work space and optionally select to use this as the default.  You can close the Welcome screen so we can get to work.

If you are running behind a firewall and need to configure a proxy server to download files from an external web site, select the Preferences menu item under the Window menu, expand the General node in the preferences tree and select Network Connections, change the drop-down to Manual, edit the http and https entries to provide the name of the proxy server and the port.

Click on the Windows menu item, select Show View, and select the Servers view.



Then click on the link “No servers are available.  Click this link to create a new server”. 

Expand Oracle, select Oracle WebLogic Server Tools, and click on Next.


It will then go off and get a bunch of files including the Oracle Enterprise Pack for Eclipse (OEPE).  You will need to accept the OEPE license agreement to finish the installation.   The installation will continue in the background.  Click on the progress bar in the lower right order to wait for it to complete.  Eventually it will complete and ask if you want to restart Eclipse.   Eclipse needs to restart to adopt the changes. 

To pick up where you left off, click on the Windows menu item, select Show View, select the Servers view, click on the link “No servers are available.  Click this link to create a new server”, expand Oracle, and select Oracle WebLogic Server.

If you want to access the server remotely, you will need to enter the computer name; otherwise using localhost is sufficient for local access.  Click Next.

On the next screen, browse to the directory name where you installed WLS and then select the wlserver subdirectory (i.e., WebLogic home is always the wlserver subdirectory of the installation directory).  Eclipse will automatically put in the value of JAVA_HOME for the “Java home” value.  Click Next.

On the next screen, browse to the directory where you created the domain using the WLS Configuration Wizard (you can also click on the button to select from known domains).  Click Next and Finish.

You can double-click on the new server entry that you just created to bring up a window for the server.  Click on “Open Launch configuration” to configure any options that you want while running the server and then click OK.

Back in the server view, right click on the server entry and select start to boot the server.

A Console window will open to display the server log output and eventually you will see that the server is in RUNNING mode.

That covers the logistics of getting everything installed to run WLS in Eclipse.  Now you can create your project and start your development.  Let’s pick a Dynamic Web Project from the new options.

The project will automatically be associated with the server runtime that you just set up.  For example, selecting a dynamic web project will display a window like the following where the only value to provide is the name of the project.

There are many tutorials on creating projects within Eclipse, once you get the tools set up.


Join the discussion

Comments ( 9 )
  • Menachem Salomon Wednesday, June 20, 2018
    I figured this out for myself, starting on JDK 6, WLS 10.3.5, and Eclipse 3.6 (Helios). (The first time around, OEPE came along with a JDK and Eclipse.)

    But starting with WLS 12.2, the installation process required Administrator privileges, as noted in the article. Is there any reason for this change, and is there any way around it?
  • Stephen Felts Monday, June 25, 2018
    WebLogic Server installation needs to be done as an administrative user on Windows starting as early as 12.1.2. There is no way around this.
  • Sam Tuesday, October 15, 2019
    I had this running well, but since running my project as a Java app locally with a main() method for debugging purposes, when I return to start the server, I get a 404 error, even though the server and app seem to be running. How do I get this automatic runtime association back?
  • Vishwas Thursday, February 20, 2020
    What is domain directory in the 5th screen shot?
  • Luis Wednesday, April 8, 2020
    Hi there.

    I'm getting the following message: Unable to connect to repository http://download.oracle.com/otn_software/oepe/oxygen/content.xml

    If I visit the URL it promts a 404 from Oracle... Is there a new way to do this? Thx.
  • Andreas S. Wednesday, September 23, 2020
    Now we have 2020 and the Oracle Weblogic Server Tools still require JDK 8. Eclipse now requires JDK 11, which makes it incompatible with the Oracle Tools.

    Will Oracle ever update their stuff?
  • Stephen Felts Tuesday, October 27, 2020
    To download Oracle Enterprise Pack for Eclipse, go to
    and click on Download.
  • Stephen Felts Tuesday, October 27, 2020
    WebLogic Server was released in March of 2020. It is supported with Java SE 8 and Java SE 11. It supports Java EE 8 API's.
  • Stephen Felts Tuesday, October 27, 2020
    In the fifth screen shot, the Domain directory is the directory in which the WebLogic Server domain is created. The directory will have a config subdirectory for the configuation, servers, bin, etc.
    By default, it is created under
Please enter your name.Please provide a valid email address.Please enter a comment.CAPTCHA challenge response provided was incorrect. Please try again.