Installing the Typesafe Stack 2.0.2

The Typesafe Stack is available in several flavors, depending on your preferred choice of platform. When installing the Typesafe Stack you will have access to Scala, sbt and giter8 on your local system.

After the Stack has been installed you can try it out by opening a terminal window and typing:

$ sbt sbt-version

At that point, a variety of Scala, Play and Akka starter/sample projects can be installed via giter8 templates. For more details, see the Template Projects section below.

We also recommend that you install the Scala IDE for Eclipse, which is available at the Scala IDE for Eclipse project site.

Once you have installed the software, visit our guide to Getting Started with the Typesafe Stack.

Special Notice for Upgraders: The Typesafe Stack 2.0 installation process has been redesigned to allow for smooth upgrades to future releases.  The new installer packages include only the sbt and giter8 binaries, as well as sample applications and examples.  The rest of the stack (including Scala, Akka, and Play) is automatically downloaded when using these tools. If you have a previous version of the Typesafe Stack installed, the new installer will not overwrite or change the previous version in any way.

Windows

Download and run this exe file. Follow the installer instructions.

Mac OS X

Use Homebrew to install.  Open a terminal window and type:

$ brew install scala sbt maven giter8

You can exclude the packages you don't need (by not listing them in the line above). We do, however, recommend that you install at least Scala, sbt (or Maven, if you are developing in Java) and giter8.

Debian/Ubuntu

First you need to add the Typesafe repository information to your list of trusted sources in order for apt to work properly. Download this file and install it (by opening the file in Ubuntu Software Center).  This will properly set-up the apt.typesafe.com repository in /etc/apt/sources.list.d/typesafe-apt.list.

Then open a terminal window and type:

$ apt-get update

$ apt-get install typesafe-stack

Red Hat/CentOS - Download RPM

Click on this link to install the RPM.

Red Hat/CentOS - Yum

Create a file called typesafe.repo in the folder /etc/yum.repos.d/ containing this information:

[typesafe]
name=Typesafe RPM Repository
baseurl=http://rpm.typesafe.com/
enabled=1

Next, open a terminal window and type:

$ yum install typesafe-stack

Universal

Download this zip file or this tarball  and unpack it to your local file system.

Documentation is available in this zip file.

Template Projects

There are giter8 templates prepared for Play and Akka with Scala or Java. If you have followed the instructions above, you should have giter8 installed on your system, which is used to download the template projects.

Scala

Plain Scala project template:

$ g8 typesafehub/scala-sbt

# cd into the newly created directory and run with 'sbt run'

Akka

Akka project template for Scala (and sbt) users:

$ g8 typesafehub/akka-scala-sbt

# cd into the newly created directory and run with 'sbt run'

Akka project template for Java (and Maven) users:

$ g8 typesafehub/akka-java-maven

# cd into the newly created directory and run with 'mvn compile exec:java'

Play

Play project template for Scala users:

$ g8 typesafehub/play-scala

# cd into the newly created directory and run with 'sbt run'

Play project template for Java users:

$ g8 typesafehub/play-java

# cd into the newly created directory and run with 'sbt run'

Play-Mini

Play-mini project template for Scala users:

$ g8 pk11/play-mini-scala

# cd into the newly created directory and run with 'sbt run'

Play-mini project template for Java users:

$ g8 pk11/play-mini-java

# cd into the newly created directory and run with 'sbt run'

Sample Projects for the Typesafe Stack

The stack-examples module contains of five sample projects.

For Java:

• comet-clock
• play-empty

For Scala:

• akka-chat
• pi-calculator
• play-mini

Get all five sample projects with:

$ g8 typesafehub/stack-examples

Templates for the Getting Started Guides

You can easily install the Akka and Play tutorial templates from Getting Started with the Typesafe Stack, each of which is available in Scala and Java flavors.

Akka tutorial for Scala:

$ g8 typesafehub/akka-first-tutorial-scala

# cd into the newly created directory and run with 'sbt run'

Akka tutorial for Java:

$ g8 typesafehub/akka-first-tutorial-java

# cd into the newly created directory and run with 'mvn compile exec:java'

Play tutorial for Scala:

$ g8 typesafehub/play-scala

Play tutorial for Java:

$ g8 typesafehub/play-java