Install the IDE Plug-In For Eclipse

The Eclipse IDE for Java Developers distribution is recommended for IDE (Eclipse download site). You can install the IDE into your existing Eclipse distribution or upgrade from a previous version.
Before installing the IDE, ensure that you have these items installed on your workstation.

A supported operating system:

  • Windows 7, 8, or 10
  • macOS 10.7, 10.8, 10.9, 10.10, or 10.11
  • Ubuntu 12.04 LTS or 14.04 LTS

Java SE Development Kit (JDK), Runtime Environment 8, or later (Java download site).

Note: 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.

  1. Launch Eclipse and select 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. To install an older version of the plug-in (for example, if you don’t have Java 8), deselect Show only the latest versions of available software. Eclipse downloads the list of available plug-ins and displays them in the Available Software dialog.
  6. Select IDE.
  7. If you want to install the Apex Debugger or our tools for working with Lightning components, select Debugger or Lightning Support.
  8. Click Next.
  9. In the Install Details dialog, click Next.
  10. In the Review Licenses dialog, accept the terms and click Finish.
  11. If you chose to install support for Lightning components, Eclipse displays a warning dialog about installing software that contains unsigned content. We are bundling third-party plug-ins to support Lightning components. Salesforce doesn’t own these third-party plug-ins; hence, we don’t sign them. Click OK to proceed.
  12. Eclipse downloads and installs the IDE and the required dependencies. When the installation is complete, you are prompted to restart. Click Yes.
  13. When Eclipse restarts, select Window | Open Perspective | Other. Select and then click OK.
    You are now ready to develop and customize applications in Eclipse!

Note: When you create a project, you are sometimes prompted for a new master password. This master password is a separate password of your choosing. It’s required by Eclipse secure storage but not associated with your IDE credentials.