Force.

com IDE Installation

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

Supported operating system (List of supported platforms) Java SE Runtime Environment 6 (v1.6) or later (Java download page) Eclipse 4.2 "Juno" (Eclipse 4.2 download site) or Eclipse 4.3 "Kepler" (Eclipse 4.3 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 "Force.com IDE" and the Location to "http://media.developerforce.com/forceide/eclipse42" and click OK. (Use the same URL for Eclipse 4.3.)

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.

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 theEclipse Workbench User Guide.

Solutions to Common Problems

Problem

Installation fails with the message, "No repository found at http://media.developerforce.com/force-ide/eclipse42. Error reading update sitehttp://media.developerforce.com/force-ide/eclipse42."

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:

1 Cannot complete the install because of a conflicting dependency. 2 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.