WebSphere Liberty for developers

The lightweight WebSphere Liberty is production-ready and designed for developers.

Installation Instructions

There are multiple ways to download and install the WebSphere Liberty v24.0.0.8 packages:

• As a stand-alone ZIP file that you unzip.
• From within Maven or Gradle as a dependency
• As a container using docker, or podman
• From within your Eclipse IDE

Installing from the ZIP file

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

Installing using Maven, Gradle, or Docker

If you're using Maven:

 io.openliberty.tools liberty-maven-plugin 3.10.3  com.ibm.websphere.appserver.runtime wlp-kernel 24.0.0.8 zip   

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

If you're using Gradle:

buildscript < repositories < mavenCentral() >dependencies < classpath 'io.openliberty.tools:liberty-gradle-plugin:3.8.3' >> apply plugin: 'liberty' dependencies

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

If you're using Docker, we recommend using our images on icr.io:

docker pull icr.io/appcafe/websphere-liberty

docker pull websphere-liberty

Installing from within Eclipse

To install WebSphere Liberty using Eclipse:

1. Open the Servers view in Eclipse (if not visible in the menu select Window >View >Others then enter servers in the Show View dialog and click OK.
2. Right click in the servers view.
3. Click New >Server
4. Select IBM > Liberty Server and click Next . If this option is not visible install the WebSphere Developer Tools using the instructions below.
5. Select the Install from an archive or a repository radio button and click Next.
6. Enter a file path into the destination path field.
7. Select the Download and install a new runtime environment from ibm.com radio button.
8. Select a Liberty Runtime install from the list.
9. Click Next on this screen and the next.
10. Accept the license agreement.
11. Click Finish.

If you do not yet have IBM Liberty Developer Tools installed follow these steps. Note the IBM Liberty Developer Tools version and the Liberty runtime version are unrelated and as a result do not have to match.

2. Drag the following Install button onto the Eclipse toolbar then follow the prompts. This installs the WebSphere Developer Tools into your Eclipse installation.

The featureUtility command (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/featureUtility installFeature adminCenter-1.0

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

bin/featureUtility installServerFeatures serverName

Download Package

WebSphere Liberty is licensed software. By downloading and using the software, you agree to be bound by the terms of the software license agreement. If you do not agree to be bound by these terms, do not download or use the software.

Each accompanying signature file can be used to verify the corresponding download package. The public key necessary for the verification process is located here.