JavaFX 2.1 Installation Guide


1 JavaFX Installation for Microsoft Windows

This page provides information about the installing the JavaFX 2.1 SDK on Microsoft Windows.

See the following topics:

Download the JavaFX Installer that Meets Your Needs

There are various ways that you can install JavaFX 2.1

  • You can install JDK 7 update 4 and JavaFX 2.1 SDK (including Runtimes) with a single installer. Get the JDK 7u4 installer at

  • If you want to continue to run JDK 6 on Windows, you can download and install the JavaFX 2.1 SDK installer independently from JDK 7u4. The JavaFX SDK installer also installs the JavaFX 2.1 Runtime. Download the JavaFX 2.1 SDK from the JavaFX Downloads page at

  • If you only want to run JavaFX 2.1 applications but do not plan to develop them, download the JavaFX 2.1 Runtime installer from the JavaFX Downloads page


There is a 32-bit or 64-bit JavaFX available for whichever JDK you have installed. If you have both the 32-bit and 64-bit JDK installed, download the 64-bit JavaFX SDK.

Whichever installer you download, it is important that you check the system requirements at the following locations:

JavaFX Installation Instructions


Only one version of the JavaFX SDK and JavaFX Runtime can be installed at a time. The JavaFX Runtime installer will automatically uninstall previous versions.

Double-click the .exe file of whichever installer you downloaded. If you use a bundled installer, the installers run in the following order:

  • JDK

  • JavaFX SDK

  • JavaFX Runtime


If you plan to use NetBeans IDE, consider installing the JavaFX SDK to the default location. It will require less configuration. For more information, see Setting Up NetBeans IDE With JavaFX at

The default installation directory for the JavaFX 2.1 SDK is C:\Program Files\Oracle\JavaFX 2.1 SDK. See JavaFX SDK File Structure for the directories and contents.

The default installation directory for the JavaFX 2.1 Runtime is C:\Program Files\Oracle\JavaFX 2.1 Runtime.

For more information about JDK installation and system requirements, see the JDK Installation Guide at

Installing NetBeans IDE

The JavaFX 2.1 SDK requires a minimum of NetBeans IDE 7.1.2. Download the NetBeans IDE from the JavaFX Downloads page.

For information about configuring NetBeans IDE to run with JavaFX, see Setting Up NetBeans IDE With JavaFX at

Viewing and Using JavaFX Samples

Sample JavaFX applications are available to download as a zip file from the JavaFX Downloads page.

Extract the files to your file system, then open samples_readme.txt for more information.

JavaFX Scene Builder

JavaFX Scene Builder is a design tool for the JavaFX platform. You can download it from the following location:

JavaFX SDK File Structure

By default, the JavaFX SDK software is installed at C:\Program Files\Oracle\JavaFX 2.1 SDK. It contains the directories and content shown in Figure 1-1.

Figure 1-1 Directories and Content of the JavaFX SDK

Description of Figure 1-1 follows
Description of "Figure 1-1 Directories and Content of the JavaFX SDK"


Contains the JavaFX Packager tool for compiling, packaging, signing, and deploying JavaFX applications.


Contains the API documentation. For online versions of the API documentation and JavaFX tutorials, see


Contains the following JavaFX utility jar files:

ant-javafx.jar: Ant tasks for packaging and deployment.

javafx-doclet.jar: A doclet for producing customized and nicely formatted documentation for the users of your JavaFX library.

javafx-mx.jar: A file used for debugging.


Contains a private, embedded copy of the JavaFX Runtime installation, used by JavaFX SDK development tools. You would typically point to the installed JavaFX Runtime instead, whose default location is C:\Program Files\Oracle\JavaFX 2.1 Runtime


This directory contains the same set of JAR files as the lib directory and is maintained for backward compatibility with NetBeans 7.1.1.


Copyright information for the JavaFX software and documentation.


Provides a link to the README index page for the Java SE, JavaFX SDK, JavaFX Runtime.


License information for third-party software included in the JavaFX SDK.

Uninstalling JavaFX

To uninstall JavaFX, use the standard Windows Add/Remove Programs utility in Control Panel. You must uninstall the JavaFX SDK and Runtime separately.


Here are some tips for working around problems that are sometimes seen during or following an installation.

  1. If you installed the 64-bit version, you may have problems with applications that run on 32 bits. Note that the 32-bit version is compatible with both 32-bit and 64-bit systems, but the reverse is not true. See the JavaFX Supported System Configurations at

  2. Verify that you have a supported environment. See the JavaFX System Requirements document at

  3. Check the release notes for known issues at

  4. Ensure that the JavaFX Runtime is installed. Go to Control Panel, choose Add/Remove Programs, and verify that JavaFX 2.1.0 appears in the list of installed applications.

  5. Try running the JavaFX pre-built samples. See Viewing and Using JavaFX Samples.

  6. Check your JDK/JRE installation running a standard Java applet, Web Start application, or JAR application.

  7. If you still have unresolved issues, go to the JavaFX Forum at