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

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

Prerequisites

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 "Force.com IDE" and the Location to "http://media.developerforce.com/force-ide/eclipse42" and click OK. (Use the same URL for Eclipse 4.3.)

    Add Site

  4. Eclipse downloads the list of available plugins and displays them in the Available Software dialog.
  5. Check the box next to the Force.com IDE plugin and click Next.

    Select Force.com IDE plugin

  6. In the Install Details dialog, click Next.
  7. In the Review Licenses dialog, accept the terms and click Finish.
  8. Eclipse downloads and installs the Force.com IDE and any required dependencies. When installation is complete, you will be prompted to restart. Click Yes.
  9. When Eclipse restarts, select Window > Open Perspective > Other, select Force.com and click OK.

You are now ready to develop and customize Force.com 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 Force.com IDE credentials. For details on Eclipse secure storage, see the Eclipse Workbench User Guide.

Solutions to Common Problems

Problem

Solution

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



Problem

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

Solution

  • 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"



Problem

Attempting to install the Force.com IDE generates the following error:

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

Solution

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.