Helidon: Java Libraries for Microservices

Project Helidon is a set of Java Libraries for writing microservices. Your application is a Java SE program running on the new Helidon Níma WebServer that has been written from the ground up to use Java 27 virtual threads. With Helidon 27 you get the high throughput of a reactive server with the simplicity of thread-per-request style programming.

Upgrading from Helidon 4? See the Helidon 27 Upgrade Guide for changes to dependencies, APIs, and application configuration.

New to Helidon? Then jump in and get started.

Java 27 is required to use Helidon 27.

License

Helidon is available under Apache License 2.0.

Documentation

Documentation for this version is available in docs. The latest released documentation and Javadocs are available at https://helidon.io/docs/latest.

Helidon White Paper is available here.

Get Started

See Getting Started at https://helidon.io.

Downloads / Accessing Binaries

There are no Helidon downloads. Just use our Maven releases (GroupID io.helidon). See Getting Started at https://helidon.io.

Helidon CLI

macOS:

curl -O https://helidon.io/cli/latest/darwin/helidon
chmod +x ./helidon
sudo mv ./helidon /usr/local/bin/

Linux:

curl -O https://helidon.io/cli/latest/linux/helidon
chmod +x ./helidon
sudo mv ./helidon /usr/local/bin/

Windows:

PowerShell -Command Invoke-WebRequest -Uri "https://helidon.io/cli/latest/windows/helidon.exe" -OutFile "C:\Windows\system32\helidon.exe"

See this document for more info.

Build

You need JDK 27 to build Helidon 27.

You also need Maven. We recommend 3.8.0 or newer.

Full build

$ mvn install

Checkstyle

# cd to the component you want to check
$ mvn validate  -Pcheckstyle

Copyright

# cd to the component you want to check
$ mvn validate  -Pcopyright

Spotbugs

# cd to the component you want to check
$ mvn verify  -Pspotbugs

Documentation

# in the docs directory
$ mvn package -Pjavadoc

Build Scripts

Build scripts are located in etc/scripts. These are primarily used by our pipeline, but a couple are handy to use on your desktop to verify your changes.

• copyright.sh: Run a full copyright check
• checkstyle.sh: Run a full style check

Get Help

• See the Helidon FAQ
• Ask questions on Stack Overflow using the helidon tag
• Join us on Slack: #helidon-users

Contributing

• Learn how to contribute
• See issues for issues you can help with

Stay Informed

• Twitter: @helidon_project
• Blog: Helidon on Medium