README.md

OpenLiberty

Summary

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

Table of Contents

• Getting Started
• Contribute to Open Liberty
• Community

Getting Started

Downloading

You can download released versions and nightly build artifacts from: https://www.openliberty.io/downloads/

Quick start

git clone https://github.com/OpenLiberty/sample-getting-started.git
cd sample-getting-started
mvn clean install

Open browser to http://localhost:9080/ and explore the demo application. Afterwards run mvn liberty:stop-server to stop the server.

Open Liberty Guides

Visit the OpenLiberty website for a number of step by step guides.

Contribute to Open Liberty

Our CONTRIBUTING document contains details for submitting pull requests.

1. Clone the repository to your system.

   git clone git@github.com:OpenLiberty/open-liberty.git

2. Run a gradle build.

   cd open-liberty/dev

   ./gradlew cnf:initialize

   ./gradlew assemble :com.ibm.websphere.appserver.features:releaseNeeded

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

   open-liberty\dev\cnf\release\dev\openliberty\<version>\openliberty-xxx.zip

5. Go Open issues, Review existing contributions, or Submit fixes.

Community

1. Open Liberty group.io
2. OpenLibertyIO on Twitter
3. open-liberty tag on stackoverflow