Create An Application Using the Web Interface
Once installed you can run Typesafe Activator's web interface either from a file browser or from a command line. From a file browser, double-click on either the
activator (for Mac & Linux) or
activator.bat (for Windows) script. From a command line, run the script with a
This will start a local web server that can be reached at: http://localhost:8888
Inside your browser you can now create a new application based on one of the 72 templates. Both Typesafe and the community have contributed templates to Activator. Learn more about how to contribute your own template.
Once you have selected a template and optionally entered a name and location, select the "Create" button to have your new application created.
Create An Application Using the Command Line
If you'd prefer to create a new application from a command line, run:
You will then be prompted to enter an application name and the template name to start with. The output will look similar to this:
Enter an application name > hello-scala The new application will be created in /home/typesafe/Desktop/hello-scala Enter a template name, or hit tab to see a list of possible templates > hello-akka hello-play hello-scala reactive-stocks > hello-scala OK, application "hello-scala" is being created using the "hello-scala" template. To run "hello-scala" from the command-line, run: /home/typesafe/Desktop/hello-scala/activator run To run the test for "hello-scala" from the command-line, run: /home/typesafe/Desktop/hello-scala/activator test To run the Activator UI for "hello-scala" from the command-line, run: /home/typesafe/Desktop/hello-scala/activator ui
Open an Existing Application Using the Web Interface
Existing applications can be opened by running
activator.bat from a project's root directory. If the Activator UI is already running, then open http://localhost:8888/home in your browser and either select a known existing app, or click the Find Existing button to browse to an existing app.
Working with Applications in the Activator UI
Once you have created or opened an application in the Activator UI you can:
- Read the Tutorial
- Browse & edit the code (select Code)
- Open the code in IntelliJ IDEA or Eclipse (select Code then the Open dropdown)
- See the compile output (select Compile)
- Test the application (select Test)
- Run the application (select Run)
- Create a new application or open an existing one (select the application's name in the top right)
Whenever you save changes to a source file in the application, the changes will be recompiled, the application will be re-run, and the tests will be re-run.
To make it easy to re-launch Activator (either from a file browser or command line) after you've shut it down, you can either launch it the same way you did the first time, or you can launch it from the new application's root directory. If you launch it from the application's root directory then the UI will automatically launch with the application open. Otherwise you will need to open the existing application. To make it easy for others to launch Activator for your application you can put the
activator-launch-VERSION.jar files in your SCM.
Typesafe Console Integration
The Typesafe Console visualizes the internals of Play Framework and Akka applications in real-time. To enable the Console you will need a free Typesafe.com account since the Console is licensed under the Typesafe Subscription Agreement which allows it to be used at development time for free. Production use requires a Typesafe Subscription.
The Typesafe Console can be enabled for applications that use Play 2.2.0+ and/or Akka 2.2.0+. To enable the Console within an application in Activator, select Run, and then Login. If you don't have an account, simply sign up and then login inside Activator (click the person icon in the top right to open the login form).
Once logged in, click the Restart with Console button to start the selected application with Console support. There will then be a link to the Console UI. Open that link to enter the Typesafe Console.
Behind a proxy
When running activator behind a proxy, some additional configuration is needed. First, we need to open the activator configuration file,
found in your user home directory under
~/.activator/activatorconfig.txt. Note that this file may not exist. Once you have
the file open and ready to configure, we need to make sure it has the following lines:
# This are the proxy settings we use for activator -Dhttp.proxyHost=PUT YOUR PROXY HOST HERE -Dhttp.proxyPort=PUT YOUR PROXY PORT HERE # Here we configure the hosts which should not go through the proxy. You should include your private network, if applicable. -Dhttp.nonProxyHosts="localhost|127.0.0.1" # These are commented out, but if you need to use authentication for your proxy, please fill these out. #-Dhttp.proxyUser=PUT YOUR PROXY USER HERE #-Dhttp.proxyPassword=PUT YOUR PROXY PASSWORD HERE
Increasing the Timeout
By default Activator has a 10 second timeout to fetch the latest templates and check for a new version. On slow internet connections it might be necessary to increate that timeout. You can do that from the command line by including a
-Dactivator.timeout=30s parameter or by putting that parameter into your
Under the Covers
Activator applications use sbt under the covers. This means that anything you can do in sbt you can do with an application in Activator. For instance, sbt plugins can easily be added to applications in Activator just like they would normally be added.
The templates available in Typesafe Activator are licensed individually by the owner. Refer to template source code or owner for license information.