§Lagom Java prerequisites
Before starting with Lagom, check to make sure that you have the correct versions of a Java Development Kit (JDK) and build tool. Your build tool must also have internet access.
Reference these sections for help with:
Before installing a build tool, verify that you have a Java Development Kit (JDK), version 8 or higher and that your machine is configured correctly.
Check the JDK version by running
javac from the command line:
java -version javac -version
java, the console should respond with the major version number of 1.8, the following shows an example of what you would see in the shell with a 1.8.0_74-b02 build:
java version "1.8.0_74" Java(TM) SE Runtime Environment (build 1.8.0_74-b02) Java HotSpot(TM) 64-Bit Server VM (build 25.74-b02, mixed mode)
javac, the console should respond with something similar to:
If you have the correct JDK and the console cannot find
javac, search the web for information about setting environment variables on your system. For example, the following pages provide tips for configuring Java:
* On systems running Linux
* On MacOS
* On Windows systems
If you do not have the correct JDK, download it from the Oracle website.
Lagom requires Maven 3.2.1 or higher, we recommend that you use at least Maven 3.3. In addition to verifying the version on the command line, check that your IDE is using the correct version.
To check the Maven version from a command line, enter:
To install Maven, see the official Maven installation page.
sbt is a build tool for Java and Scala. Lagom requires sbt 0.13.5 or higher. To create new projects using Lagom-supplied templates, use sbt 0.13.13 or higher, which contains the sbt new command.
In a console, check your version using the
The system should respond with something like the following:
[info] Set current project to example (in build file:/home/example/) [info] 0.13.13
§Internet access through a proxy
If you access the internet through a proxy, make sure that your build tool can connect to the proxy:
For sbt, an
HTTP_PROXYenvironment variable should point to your proxy’s URL, for example,
For Maven, see the documentation on configuring a proxy.