Lagom - Get started

Lagom is Approaching EOL

This project will only receive security patches until July 1, 2024, at that point the project will no longer receive any additional patches.

If you are an existing customer of Lightbend and we have not yet contacted you, please reach out to Support.

We recommend migrating any existing work to:

Akka for deeply customized projects with complex infrastructure needs. Akka now contains the vast majority of Lagom features.
Kalix for a managed scalable environment with an abstraction above the Akka framework layer to allow you to focus only on business logic.

Before starting, make sure that you have JDK 8 installed and configured. See Lagom documentation for information on verifying your Java version.

We’ve made it easy to create your first project. The link below creates a Lagom Giter8 template to generate a compressed file that contains:

A distribution of sbt for building and running your project (version 1.4.x, or later, recommended).
A Lagom Hello World project.

Download the project .zip file (clicking initiates the download)
Extract the compressed file to a directory of your choice.

Note: On macOS, if you unzip using Archiver, you also have to make the sbt files executable:
```
chmod u+x ./sbt 
```
```
chmod u+x ./sbt-dist/bin/sbt
```
In a shell, change into the top-level directory of the project, lagom-java-sbt. For example, if you extracted the project into a directory named my-project:
- In a macOS or Linux shell:
```
cd my-project/lagom-java-sbt
```
- In a Windows shell:
```
cd my-project\lagom-java-sbt
```
Start sbt and the Lagom development environment:
```
./sbt runAll
```
It will take a bit of time to build and run the project. When finished, the console displays the message: Services started, ....
Verify that the services are indeed up and running by invoking the hello service endpoint from any HTTP client, such as a browser: http://localhost:9000/api/hello/World

The request returns the message Hello, World!.

Congratulations! You've created and run your first Lagom system. See the Lagom documentation to learn more about your new project.