====== Debugging in Grails 3 ======
Author : Brian Coffey
\\ Date : 2017-02-03

To debug a grails 3.x.x application in IntelliJ Idea a new remote configuration needs to be created.

=== Step 1 ===
Go into the 'Edit Configuration' menu as shown in the image below.

{{:development:grails:editconfig.png?600|}}

=== Step 2 ===
Create a new remote confguration using the '+' symbol in the top lef hand corner and select the remote option as shown below.

{{:development:grails:remoteconfig.png?300|}}

=== Step 3 ===
Use the parameters shown in the image below, the majority, if not all of these will be the defaults.

{{:development:grails:debugsettings.png?500|}}

=== Step 4 ===
To actually debug the application, run the application as normal and then select your newly created debug remote configuration and run that in debug mode as shown in the below image.

{{:development:grails:rundebug.png?350|}}

===== Note =====
Two instances of the debug configuration cannot listen on the same port (5005)!!