Troubleshoot the Force.com IDE: Debug Mode

Force.com IDE is in a maintenance-only state. We still provide support for the product through our official channels, but updates prior to October 12, 2019 will be only for critical security issues that arise. On October 12, 2019, we will no longer provide support or updates of any kind for Force.com IDE. On that date, we will also begin archiving documentation and removing download links for the product. We recommend that you start migrating to Salesforce Extensions for Visual Studio Code or one of the great tools made by our partners. For more information, see The Future of Salesforce IDEs on the Salesforce Developers Blog.

Warning

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