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.
- 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 https://wiki.eclipse.org/Eclipse.ini.
- 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.
- Launch Eclipse and click Help > Install New Software....
- Click Add....
- 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.)
- 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."
- Eclipse downloads the list of available plug-ins and displays them in the Available Software dialog.
- Check the box next to the Force.com IDE plug-in and click Next.
- In the Install Details dialog, click Next.
- In the Review Licenses dialog, accept the terms and click Finish.
- Eclipse downloads and installs the Force.com IDE and any required dependencies. When installation is complete, you will be prompted to restart. Click Yes.
- 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
- Configure Eclipse to use your proxy server. These settings can be found in your Eclipse Preferences, under General > Network Connections.
- On Mac OS X, "Force.com" 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 "Force.com" 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 Force.com IDE generates the following error:
Cannot complete the install because of a conflicting dependency.
Software being installed: Force.com 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.