Skip to content

Open Liberty is a highly composable, fast to start, dynamic application server runtime environment


Notifications You must be signed in to change notification settings


Repository files navigation


Maven Central Container Images Website Stack Overflow License Twitter


A lightweight open framework for building fast and efficient cloud-native Java microservices:

  • Open Liberty is fast to start up with low memory footprint and live reload for quick iteration.
  • Simple to add and remove features from the latest versions of MicroProfile and Java EE.
  • Zero migration lets you focus on what's important, not the APIs changing under you.

Getting Started

Launch a sample app using Maven

git clone
cd sample-getting-started
mvn clean package liberty:run

Open browser to http://localhost:9080/ and explore the demo application.

See this guide to learn how it works.




  • This guide demonstrates development using Docker containers.


  • This guide demonstrates development using the Liberty Maven Plugin.

Command Line

Open Liberty Docs


Our CONTRIBUTING document contains details for submitting pull requests. FYI: The project recently renamed master branch to release. More info here:

Running a Build

  1. Clone the repository to your system.

     git clone
  2. Run a gradle build.

     cd open-liberty/dev
     ./gradlew cnf:initialize
     ./gradlew assemble
  3. Run the unit or FAT tests.

    ./gradlew test for unit tests

    ./gradlew build.example_fat:buildandrun to run a FAT project

    NOTE: ./gradlew build runs the assemble and test tasks

  4. Perform a local release

    ./gradlew releaseNeeded

    NOTE: This task releases all projects to the local releaseRepo. The final openliberty zip can be found in



Usage is provided under the EPL 2.0 license See LICENSE for the full details.