Lagom consists of:
sbt is a build tool for Java and Scala. Activator adds a few features to sbt, notably the ability to start new projects from templates available online.
Because Activator includes sbt, you don’t need to install anything except a JDK and Activator. Activator will retrieve the Lagom plugin and libraries for use within your project.
Note that if you aren’t using the optional project templates, you don’t strictly need Activator; sbt itself is enough. The examples in this manual always show the
activator command, but unless the command is
activator new, you can always substitute
§Activator version (Read me!)
Older installations of Activator may cause OutOfMemoryException when using the Lagom development environment. To avoid this issue, make sure you are using the Activator package version 1.3.10+. Here is how you can check what version of the Activator package you are using on Linux systems (for Windows users, just check what’s in your
%PATH% environment variable):
$ which activator /opt/activator-1.3.10-minimal/bin/activator
The important bit is that the
activator-<version> must be at least 1.3.10 for Lagom to properly work.
Follow this link to download the latest activator bundle.
If you already have Activator and JDK 8, you can skip ahead to Getting Started.
Otherwise, follow these steps:
- Ensure you have Oracle JDK 8 installed on your system.
- Download latest Activator
- Extract it to a location where you have access.
- Add the Activator installation directory to your
Some package managers can handle steps 2, 3, and 4 for you. For example, if you use Homebrew on Mac OS X, then
brew install typesafe-activator and you’re done.
More detailed information on these steps follows.
Lagom requires JDK 8 or later. Early JDK 8 releases had bugs that could affect Lagom, so you’ll want to use a recent build.
You can check whether you have JDK 8 by running
javac from the command line:
$ java -version 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 -version javac 1.8.0_74
If you don’t have java and javac, you can get it from the Oracle Java downloads page.
To install Activator, download the latest version and extract it to a location that you have write access to.
Activator needs write access to its installation directory. On Linux/Unix installations, this means that you shouldn’t extract it to somewhere that you don’t have write access to, for example
activator script needs to be executable. If not, you can make it executable by running
chmod u+x /path/to/activator.
For convenience, you should add the Activator installation directory to your system
- On Linux/Unix, this can be done by adding
export PATH=/path/to/activator:$PATHto your
- On Windows, add
PATHenvironment variable. Do not use a path with spaces.
If you can only access the web through a proxy, set the
HTTP_PROXY environment variable to your proxy’s URL, for example,