Getting started with a new web framework can be a bit scary. Luckily, Scalatra is easy to install, as it has relatively few dependencies.

It can run on Windows, Mac OS X, Linux, or BSD.

1. Install a JDK

Scalatra is web micro-framework written in Scala, so you’ll need to have a Java Development Kit (JDK) installed.

Many systems come with a JDK pre-loaded.

Run java -version and javac -version in a terminal to find if yours does. The output should look something like this:

$ java -version
java version "1.8.0_11"
Java(TM) SE Runtime Environment (build 1.8.0_11-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.11-b03, mixed mode)
$ javac -version
javac 1.8.0_11

You need Java 8, which will show up as version 1.8. Java 7 is no longer supported in Scalatra 2.5.

If you don’t yet have Java installed, you can find out how to install it for your system over at the Java 8 install page. Make sure you’re using OpenJDK or Sun’s JDK.

Some Linux distros pre-install gcj, which won’t work.

2. Install giter8

Once you’re sure you’ve got Java installed, you will need to download a few other utilities.

Conscript is a tool for installing and updating Scala code. giter8, which depends on conscript, allows you to check out project templates directly from Github. It’s the recommended way to generate Scalatra project skeletons.

Install conscript

curl | sh

This will create a bin folder in your home directory. Make sure it’s in your PATH by adding the following to your shell’s profile (often ~/.bash_profile on Mac and ~/.bashrc on Linux):

export PATH
source ~/.bash_profile # (Mac)
source ~/.bashrc       # (Linux)

Install giter8

cs foundweekends/giter8

Depending on your connection speed, this can take a bit of time, as conscript downloads quite a few Scala dependencies.

Alternatively, you can install giter8 on a Mac via homebrew:

brew install giter8

With installation out of the way, head over to the “first project“ page, which will show you how to generate, build, and run a Scalatra application.