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 7, or later (Java download page)
    • The plug-in doesn't load if you don't have the full Java Development Kit (JDK). The full JDK is not the default JRE installation on Mac OS X.
    • 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.x (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....

    Install New Software

  2. Click Add....
  3. In the Add Repository dialog, set the Name to " IDE" and the Location to "" and click OK. (Use the same URL for Eclipse 4.3.)

    Add Site

  4. If you want to install an older version of the plug-in (for example, if you do not have Java 7), be sure to clear the option "Show only the latest versions of available software."

    Show All IDE Versions

  5. Eclipse downloads the list of available plug-ins and displays them in the Available Software dialog.
  6. Check the box next to the IDE plug-in and click Next.

    Select IDE plugin

  7. In the Install Details dialog, click Next.
  8. In the Review Licenses dialog, accept the terms and click Finish.
  9. Eclipse downloads and installs the IDE and any required dependencies. When installation is complete, you will be prompted to restart. Click Yes.
  10. 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



  • Configure Eclipse to use your proxy server. These settings can be found in your Eclipse Preferences, under General > Network Connections.


  • On Mac OS X, "" perspective does not appear in Eclipse despite having the current version of the Java Runtime Environment.


  • Download the full version of the Java SE Development Kit (JDK) from the Java download page.


  • Installation succeeds on Windows, but the "" perspective does not appear under Windows > Open Perspective > Other...


  • Add the explicit path to the JRE in the eclipse.ini file that is in the directory where you installed Eclipse. The line should be "-vm <full path to your jre>\javaw.exe"


Attempting to install the IDE generates the following error:

 Cannot complete the install because of a conflicting dependency.
   Software being installed: IDE...


Move Eclipse to a folder other than Program Files. See this thread for more details.

Didn't find the answer to your problem? Get help from a product expert on the discussion forums.