Setup
IDE
You can use any Java IDE for this tutorial but if you haven’t tried it before, we recommend VS Code with the Language Support for Java™ by Red Hat and the Quarkus extensions.
|
If you are using VS Code, then install the VS Code Remote Development Extension pack, which allows you to run this entire tutorial within a container that will have all tools configured. |
CLI Tools
The following CLI tools are recommended for running the exercises in this tutorial.
|
Installing GraalVM is only required if you intend to build a native binary for your local operating system and don’t have a container runtime. Quarkus can simply build the native binary inside a container and this way you don’t need to install and configure GraalVM on your machine. |
| You can also use Docker instead of Podman. The advantage of Podman is that it is 100% Free Open Source and does not need to run with elevated privileges. |
Please have them installed and configured before you get started with any of the tutorial chapters.
| Tool | macOS | Fedora | Windows |
|---|---|---|---|
Podman Desktop* |
|||
Java 21 |
|
|
Windows (Make sure you set the |
Apache Maven 3.8.6+ |
|
|
Windows (Make sure you set the |
GraalVM for Java 21 [Optional] |
|
If you are using Linux, macOS or WSL on Windows, you can also install the required tools using SDKMAN!. This allows easy version/distribution switching (and you can install the Quarkus CLI with it as well). Alternatively on Windows you can also try Chocolatey which works similarly. |
You can run the tutorial from inside a container which has all the tools listed above installed and pre-configured.
docker pull quay.io/rhdevelopers/tutorial-tools
mkdir quarkus-tutorial
cd quarkus-tutorial
mkdir work
docker run -ti -p 8080:8080 -v `pwd`/work:/work \
-v `mvn help:evaluate -Dexpression=settings.localRepository -q -DforceStdout`:/opt/developer/.m2/repository \
--rm quay.io/rhdevelopers/tutorial-tools:latest bash
# -p will map Quarkus running in the container to your host port
# -v `pwd`... will map the host work subdirectory to the container /work directory, this is where you will create your application
# -v `mvn ...` will map your ~/.m2/repository of your host to the container repository to save downloading again between image runs|
Installing SDKMAN! in the container will allow you to install the Quarkus CLI very easily: |