How to Run Java Projects in IDEA 2021.3 Using WSL, SSH, and Docker

Introduction

After updating to IntelliJ IDEA 2021.3 I explored the new support for WSL, SSH and Docker, which allows running and debugging Java applications on remote environments without extensive configuration.

Key New Features

Space integration (not used in this tutorial)

Java 16 support (not needed for the examples)

Improved Git support

Windows taskbar support

Code With Me

WSL, SSH, Docker run targets

Running on WSL

Set up JDK and JAVA_HOME inside WSL, then create a new “WSL” Run/Debug configuration in IDEA. Choose the desired distribution; a green “successfully” indicates the target is ready. After that the project runs exactly like a local execution.

Running on SSH

Configure SSH credentials, create a new SSH Run Target, specify the remote directory and JAVA_HOME, then run or debug. Note that without rsync each execution uploads all class files and dependencies.

Running on Docker

Create a simple Dockerfile (e.g., FROM openjdk:11.0.11-oraclelinux7), add a Docker Run Target, select the local Docker server, and use the Dockerfile. After the container starts, IDEA shows the mapped port and the application runs normally.

Conclusion

With minimal configuration, WSL, SSH and Docker run targets behave like local execution, providing full Run and Debug capabilities. Upgrading to IDEA 2021.3 is recommended for developers who need these remote development features.