WAS Liberty with OSGi Applications

This basic runtime package includes all you need to get up and running with a WebSphere Liberty server. To keep the footprint small, only the subset of technologies required to run OSGi applications is included.

If you need Web Services, or JMS, these can be installed through bin/installUtility.


There are two ways to download and install the WebSphere Liberty V20.0.0.10 OSGi package:

  1. From within your Eclipse IDE.
  2. As a standalone ZIP file that you unzip.

Installing from within Eclipse

Complete the following steps to install the WebSphere Liberty using Eclipse:

  1. If you don’t already have Eclipse, install Eclipse Oxygen for Java EE Developers.
  2. Drag the following Install button Drag to your running Eclipse workspace. onto the Eclipse toolbar then follow the prompts. This installs the WebSphere Developer Tools into your Eclipse installation.
  3. In the Servers view of Eclipse, right-click to define a new WebSphere Liberty server. This opens a wizard to guide you through the process. The wizard includes the option to download and install the runtime as a part of defining a new server.

Installing from the ZIP file

Complete the following steps to install WebSphere Liberty from the ZIP file:

  1. Download WebSphere Liberty V20.0.0.10 with OSGi Applications by clicking Download.
  2. Unzip.

Installing using Maven, or Gradle

If you're using Maven:


To install additional features with Maven, see the Liberty Maven plugin docs.

If you're using Gradle:

dependencies {
  libertyRuntime group: 'com.ibm.websphere.appserver.runtime', name: 'wlp-osgi', version: ''

To install additional features with Gradle, see the Liberty Gradle plugin docs.

Installing additional features

The installUtility (located in the wlp/bin folder) can be used to install additional features from the Liberty Repository such as adminCenter-1.0, servlet-3.0, collectiveController-1.0, or a feature bundle such as ndControllerBundle (includes adminCenter-1.0 and collectiveController-1.0), e.g.
bin/installUtility install adminCenter-1.0

You can also install all features required by a configured server using:

bin/installUtility install serverName

Upgrading to a supported installation

Installing WebSphere Liberty from this ZIP file enables no-charge, unsupported, unlimited use of WebSphere Liberty in development environments and limited use in small-scale test and production environments. For access to IBM support and unlimited test and production use, you can purchase and upgrade to a supported edition for your existing installation. See Upgrading Liberty profile installations

Additional information