You need to have a JDK 1.8 (or later) installed on your machine (see General Installation Tasks).
- Download the latest Typesafe Activator.
- Extract the archive on a location where you have write access.
- Change dir with cmd
cd activator*(or with the file-manager)
- Start it with cmd
activator ui(or with the file-manager)
- Access it at http://localhost:8888
You’ll find documentation and a list of application samples which get you going immediately. For a simple start, try the play-java sample.
To use play from any location on your file-system, add the activator directory to your path (see General Installation Tasks).
my-first-app based on the
play-java template is as simple as:
activator new my-first-app play-java cd my-first-app activator run
http://localhost:9000 - access your application here.
You are now ready to work with Play!
§General Installation Tasks
You may need to deal with those general tasks in order to install Play! on your system.
Verify if you have a JDK (Java Development Kit) Version 1.8 or later on your machine. Simply use those commands to verify:
java -version javac -version
If you don’t have the JDK, you have to install it:
- MacOS, Java is built-in, but you may have to Update to the latest
- Linux, use either the latest Oracle JDK or OpenJDK (do not use not gcj).
- Windows just download and install the latest JDK package.
§Add Executables to Path
For convenience, you should add the Activator installation directory to your system
On Unix, use
On Windows, add
;C:\path\to\activator to your
PATH environment variable. Do not use a path with spaces.
activator writes some files to directories within the distribution, so don’t install to
/usr/local or anywhere else you’d need special permission to write to.
Make sure that the
activator script is executable. If it’s not, do a
chmod u+x /path/to/activator.
If you’re behind a proxy make sure to define it with
set HTTP_PROXY=http://<host>:<port> on Windows or
export HTTP_PROXY=http://<host>:<port> on UNIX.
Next: Creating a new application
Found an error in this documentation? The source code for this page can be found here. After reading the documentation guidelines, please feel free to contribute a pull request. Have questions or advice to share? Go to our community forums to start a conversation with the community.