Troubleshoot the Force.com IDE: Debug Mode

If you experience errors in the Force.com IDE, it can be useful to run Eclipse in Debug Mode. Debug Mode causes the IDE to write additional information to its system log.

To turn on Debug Mode, add the following parameter to Eclipse's startup command line or in eclipse.ini:
  • -Dforce-ide-debug=true

You can view the system log within the IDE, using the Force.com Log Viewer.

You can also write the zip file to disk for each save, refresh, synchronize, or deploy action, which can be helpful in diagnosing errors. Add the following parameter to Eclipse's startup command line or in eclipse.ini:
  • -Dforce-ide-temp=<full-path-to-directory>

If you need help that is not provided in the Force.com IDE documentation, you can contact the developer.salesforce.com discussion forums. Be sure to include as much information as possible, including any relevant error log entries.

Note