Introduction

The Helidon CLI lets you easily create a Helidon project by picking from a set of archetypes. It also supports a developer loop that performs continuous compilation and application restart, so you can easily iterate over source code changes.

The CLI is distributed as a standalone executable (compiled using GraalVM) for ease of installation. It is currently available as a download for Linux, Mac and Windows. Simply download the binary, install it at a location accessible from your PATH and you’re ready to go.

Prerequisites

Helidon requires Java and Maven. You might also need Docker and Kubernetes depending on how you plan to deploy your services.

Prerequisite product versions for Helidon 4.0.10
Java SE 21 (Open JDK 21)Helidon requires Java 21+.
Maven 3.8+Helidon requires Maven 3.8+.
Docker 18.09+You need Docker if you want to build and deploy Docker containers.
Kubectl 1.16.5+If you want to deploy to Kubernetes, you need kubectl and a Kubernetes cluster (you can install one on your desktop.

You should make sure java and mvn are in your path.

java -version
mvn --version
Copied

Installation

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

If you get a warning that "the developer cannot be verified" when running the CLI this is due to the Helidon CLI not being signed and notarized yet. You can disable this check by running: xattr -d com.apple.quarantine helidon

Linux
curl -L -O https://helidon.io/cli/latest/linux/helidon
chmod +x ./helidon
sudo mv ./helidon /usr/local/bin/
Copied
Windows
PowerShell -Command Invoke-WebRequest -Uri "https://helidon.io/cli/latest/windows/helidon.exe" -OutFile "C:\Windows\system32\helidon.exe"
Copied

For Windows you will also need the Visual C++ Redistributable Runtime. See Helidon on Windows for more information.

Create a New Project

helidon init
Copied

Then answer the questions.

Developer Loop

cd myproject
helidon dev
Copied

As you make source code changes the project will automatically recompile and restart your application.

Demo

CLI Demo