The IDE is available as a plug-in for the industry-leading, open-source Eclipse project.

These instructions show you how to install the IDE into your existing Eclipse distribution or upgrade from a previous version.


  • Supported operating system (List of supported platforms)
  • Java SE Development Kit (JDK), Runtime Environment 8, or later (Java download page)
    • Be sure to download the full JDK—without it, the plug-in doesn’t load. On macOS, the full JDK is not the default JRE installation.
    • If you use Java 7, disable TLS 1.0. (TLS 1.0 is disabled by default in Java 8.) Update your eclipse.ini file to include this line:
The location of the eclipse.ini file depends on your operating system. For more information, see
For information about Salesforce’s timeline for disabling the TLS 1.0 encryption protocol, see this Knowledge Article.
  • Eclipse 4.5 or later (Eclipse download site)—the 'Eclipse IDE for Java Developers' distribution is strongly recommended

For more information on support, see the Release Notes.

Installation Steps

  1. Launch Eclipse and click Help > Install New Software....
  2. Click Add....
  3. In the Add Repository dialog, set the Name to " IDE" and the Location to For Spring ’16 ( IDE v36.0) and earlier IDE versions, use
  4. Click OK.
  5. If you want to install an older version of the plug-in (for example, if you do not have Java 8), be sure to clear the option "Show only the latest versions of available software."
  6. Eclipse downloads the list of available plug-ins and displays them in the Available Software dialog.
  7. Check the box next to the IDE plug-in and click Next.
  8. In the Install Details dialog, click Next.
  9. In the Review Licenses dialog, accept the terms and click Finish.
  10. Eclipse downloads and installs the IDE and any required dependencies. When installation is complete, you will be prompted to restart. Click Yes.
  11. When Eclipse restarts, select Window > Open Perspective > Other, select and click OK.

You are now ready to develop and customize applications in Eclipse!

Note: When you create a new project, you might be prompted about a new master password. This is a separate password of your choosing required by Eclipse secure storage, and is not associated with your IDE credentials. For details on Eclipse secure storage, see the Eclipse Workbench User Guide.

Solutions to Common Problems

See Solutions to Common Problems in the IDE Developer Guide.