Remote Debug

Last modified: 26 April 2022

Remote Debug is a feature allowing you to remotely debug your tests on the TeamCity agent machine from the IDE on the local developer machine. This feature is of use when the agent environment is unique in some aspect, which causes a test to fail, and it is difficult to reproduce the problem locally.

With TeamCity integration for IntelliJ-based IDEs enabled, remote debug sessions can be launched right from IntelliJ IDEA for the builds based on the IntelliJ IDEA Project and Ant build steps.

Currently, the following IntelliJ IDEA run configurations are supported:

  • Java application run configuration

  • JUnit run configuration

  • TestNG run configuration

Remote debug for Ant steps requires that the build configuration have the teamcity.remote-debug.ant.supported=true parameter.