dev_cli_local_debug.md

copyright	years 2016, 2017
lastupdated	2017-05-18

{:new_window: target="_blank"} {:shortdesc: .shortdesc} {:screen: .screen} {:codeblock: .codeblock} {:pre: .pre}

Local application debugging

{: #local-debug}

Local application debugging instructions are provided for the following languages:

• Java
• Node.js

Note: Swift application debugging is not supported.

Java application debugging

{: #java}

Steps to enable debug for a Java application:

1. From your application project's root directory run the following command:

   bx dev debug

2. Connecting the debugger to your application:

   • Eclipse
     1. Import the Existing maven project into Eclipse.
     2. Create a Java remote application debug configuration.
        1. Enter the IP address or localhost:<port>
        2. Enter 7777 for port number.
        3. Specify the name of the java project that you imported.
     3. Set a breakpoint in the IDE.
     4. Run the debug configuration.
     5. Access the endpoint with a browser to recreate the issue.
        Note: The default port is 9080 for the Java basic Microservices endpoint.
   • IntelliJ
   • VSCode
   • JDK command line: jdb -attach <host:port>

Node.js application debugging

{: #node}

Steps to enable debug for a Node.js application:

1. From your application project's root directory run the following command:

   bx dev debug

2. Connecting the debugger to your application:

   • VSCode
   • WebStorm