To follow the Java SDK tutorials and build your own Temporal applications with Java, you'll need the JDK, the Temporal Java SDK and a Temporal development server.
Get the Java JDK
Make sure you have the Java JDK installed. These tutorials were produced using Java SE 14.0.1. You can check which version you have installed using this command:
Get the Temporal SDK for Java
You can use Gradle or Maven for your projects, although we recommend Gradle.
Gradle is a dependency management and build tool for Java projects. You'll need it installed to work with the projects in these tutorials.
You can install Gradle separately, or use IntelliJ IDEA, which comes packaged with Gradle.
Install Gradle by following the installation instructions.
Add the following lines to your Gradle configuration to configure the Temporal SDK.
Apache Maven is another popular Java build tool.
Install Maven following the official installation instructions.
Add the following lines to your Maven configuration:
Next, you'll configure a local Temporal cluster for development.
Set up a Temporal development cluster
Download and install the Temporal development cluster locally using Docker Compose. You'll run this server in the background while you develop your applications.
Then clone the temporalio/docker-compose repository and run
docker-compose up from the root of that repo:
git clone https://github.com/temporalio/docker-compose.git
Switch to the directory:
docker compose to download the various container images and start the development cluster:
When the Temporal Cluster is running, the Temporal Web UI becomes available in your browser. Visit localhost:8080
Review other methods in the Run a dev Cluster section in Temporal's documentation.
Once you have everything installed, you're ready to build apps with Temporal on your local machine.