NetBeans IDE 8.1 Release Notes

NetBeansTM IDE is a modular, standards-based integrated development environment (IDE), written in the JavaTM programming language. The NetBeans project consists of a full-featured open source IDE written in the Java programming language and a rich client application platform, which can be used as a generic framework to build any kind of application. For information about how to install the software on your system, please see the NetBeans IDE 8.1 Installation Instructions. To learn about the new features included in this release of the IDE see the NetBeans IDE 8.1 Release Information page.


What's New in 8.1

  • Node.js support
  • HTML5/JavaScript Enhancements
  • Java Enhancements
  • PHP Enhancements
  • C/C++ Enhacements
  • Support for remote Oracle WebLogic Server
  • Community contributed WildFly 9 and 10
  • Bundling with the JRE

All the details on these and other enhancements are listed on the NetBeans IDE 8.1 New and Noteworthy page.

For more about this release, see the NetBeans IDE 8.1 Release Information page.

Supported Technologies, Servers, and Mobile Platforms

NetBeans IDE 8.1 supports the following technologies and has been tested with the following application servers and mobile platforms. If you plan to use versions other than those explicitly listed, please note that you may encounter unpredictable IDE behavior.

Supported technologies:
  • Java EE 7, Java EE 6, and Java EE 5
  • JavaFX 2.2.x and 8
  • Java ME SDK 8.0
  • Java Card 3 SDK
  • Struts 1.3.10
  • Spring 4.0.1, 3.2.7, 2.5
  • Hibernate 4.2.6, 3.6.10
  • Issue Tracking
    • Bugzilla 4.4 and earlier
    • Jira 3.13+ and 5.0+
  • Node.js 0.12.x
  • PHP 5.6, 5.5, 5.4, 5.3, 5.2, 5.1
  • Groovy 2.1
  • Grails 2.3, 2.2
  • Apache Ant 1.9.4
  • Apache Maven 3.0.5 and earlier
  • C/C++/Fortran
  • VCS
    • Subversion: 1.8, 1.7, 1.6
    • Mercurial: 2.8.x and later
    • Git 1.8.х and later

Tested application servers:
  • GlassFish Server Open Source Edition 4.1.1
  • WebLogic 12c

Known to run application servers:
  • GlassFish Server Open Source Edition 3.x
  • Tomcat 7.x and 8.0.27
  • WildFly 8, 9, and 10
  • JBoss AS 7.x
  • WebLogic 11g

Tested mobile platforms:
  • Android 4.4
  • iOS 7.0
  • Cordova 3.3

Known to run mobile platforms:
  • iOS 7.1
  • Cordova 3.4

System Requirements

NetBeans IDE runs on operating systems that support the Java VM (Virtual Machine) and has been tested on the platforms listed below.

Note: The IDE's minimum screen resolution is 1024x768 pixels.

Supported Operating Systems

Minimum Hardware Configurations

  • Microsoft Windows Vista SP1/Windows 7 Professional:
    • Processor: 800MHz Intel Pentium III or equivalent
    • Memory: 512 MB
    • Disk space: 750 MB of free disk space
  • Ubuntu 9.10:
    • Processor: 800MHz Intel Pentium III or equivalent
    • Memory: 512 MB
    • Disk space: 650 MB of free disk space
  • Macintosh OS X 10.7 Intel:
    • Processor: Dual-Core Intel
    • Memory: 2 GB
    • Disk space: 650 MB of free disk space

Recommended Hardware Configurations

  • Microsoft Windows 7 Professional/Windows 8/Windows 8.1:
    • Processor: Intel Core i5 or equivalent
    • Memory: 2 GB (32-bit), 4 GB (64-bit)
    • Disk space: 1.5 GB of free disk space
  • Ubuntu 15.04:
    • Processor: Intel Core i5 or equivalent
    • Memory: 2 GB (32-bit), 4 GB (64-bit)
    • Disk space: 1.5 GB of free disk space
  • OS X 10.10 Intel:
    • Processor: Dual-Core Intel
    • Memory: 4 GB
    • Disk space: 1.5 GB of free disk space

NetBeans IDE is also known to run on the various other Linux distributions such as Oracle Linux 5, Ubuntu 8.x, Red Hat Enterprise Linux, Fedora 14, and many others.

Note: NetBeans Web and Java EE support are particularly demanding on system resources - especially when used in combination with application servers. While the above system requirements apply to most configurations of the IDE, for the best results make sure that your system meets at least the recommended system requirements when developing Web and Java EE applications.

Required Software

NetBeans IDE runs on the Java SE Development Kit (JDK) which consists of the Java Runtime Environment and developer tools for compiling, debugging, and running applications written in the Java language.

The tested JDK for this release is JDK 8u60 for Windows, Linux, and OS X. The 8.1 version of the IDE cannot be installed or run using JDK 6.0.


  • The PHP and C/C++ NetBeans bundles only require the Java Runtime Environment (JRE) 7 or JRE 8 to be installed and run.
  • Java features in the IDE require JDK 7 or JDK 8. JavaFX 2.2 (or newer) features require JDK 7 Update 6 (or newer).
  • JavaFX 8 features require JDK 8.

You can download the JDK for your platform from the Java SE Downloads page.

Note: Java SE 7 or Java SE 8 is required to install and run NetBeans IDE 8.1.


JavaFX Support

The JavaFX SDK is not bundled with the NetBeans IDE 8.1 release.

The JavaFX 2.2 SDK (and newer) is bundled with the latest JDK 7 for Windows, OS X and Linux. You can install the JavaFX 2.2.79 SDK together with Java SE Development Kit 7u79 as a co-bundled product.

The JavaFX 8 SDK is bundled with JDK 8 for Windows, OS X and Linux. You can install the JavaFX 8 SDK together with Java SE Development Kit 8 as a co-bundled product.

Unlike previous versions of NetBeans IDE, NetBeans IDE 8.1 does not require that you set up an "FX-enabled" Java platform in order to utilize JavaFX support in the IDE. You can develop JavaFX projects in the IDE if you install any standard Java platform that is JDK 7 Update 6 or newer (JDK 7 Update 10 or newer is strongly recommended).

Please note the following:

  • The minimum supported JDK version for JavaFX 2.2.0 is Java SE 7 Update 6.
  • The minimum supported JDK version for JavaFX 2.2.5 is Java SE 7 Update 13.
  • The minimum supported JDK version for JavaFX 2.2.79 is Java SE 7 Update 79.
  • The supported JDK version for JavaFX 8 is Java SE 8.

See the JavaFX Release Documents page for more information about system requirements, supported platforms and known issues for the current and previous versions of JavaFX SDK.


SQL Editor and Databases

The following changes have been made to the database functionality in NetBeans IDE 8.1:

  • Upgraded Drivers. The MySQL drivers included in NetBeans IDE have been updated to version 6.0.
  • Tested Drivers

    NetBeans IDE 8.1 has been tested with the following databases and drivers.

    Example URL
    JavaDB Derby jdbc:derby://localhost:1527/sample (Network)
    Oracle Oracle Database 11g ( jdbc:oracle:thin:@//localhost:1521:ora11i
  • Other Drivers

    The following drivers and databases have not been formally tested, but should work based on experience.

    Example URL
    PostgreSQL 8.x jdbc:postgresql://
    MySQL MySQL Connector/J 6.0 jdbc:mysql://localhost:3306/sample
    Microsoft Microsoft SQL Server 2005 JDBC Driver 1.2.2828.100 jdbc:sqlserver://localhost:1433;databaseName=travel;selectMethod=cursor
    IBM Redistributable DB2 JDBC Type 4 driver v8 fixpack 13 jdbc:db2://localhost:50002/sample
    jTDS jTDS 1.2.1 jdbc:jtds:sqlserver://
    DataDirect DataDirect Connect for JDBC - 3.6 DataDirect Connect for JDBC - 3.6.07 jdbc:datadirect:oracle://localhost;SID=ora11i jdbc:datadirect:sqlserver://localhost:1433;DatabaseName=travel;SelectMethod=cursor jdbc:datadirect:db2://localhost:50002;databaseName=sample
  • For Database troubleshooting information please refer to the NetBeans Database Connectivity User FAQ.


Multilingual Support Information

NetBeans IDE is translated into the following languages: Brazilian Portuguese (BR), Japanese (JP), Simplified Chinese (ZH), and Russian (RU).

Community translations of the IDE are also available in several additional languages and can be downloaded from the Community Contributed section of the IDE Language drop-down menu.


Compatibility with Earlier Releases

When the IDE is run for the first time after installation you have the option to import some of the settings used in a previous installation. The IDE opens using the default settings if you choose not to import the settings from the existing installation. Note the IDE only recognizes previous installations when the user directory resides in the default location. It does not recognize installations that use the --userdir switch to specify a user directory. If you would like to import settings from a location that the installer does not recognize do the following:

  1. Start the IDE go to Tools > Options in the main menu.
  2. Click the Import button at the bottom of the Options dialog.
  3. In the Select Options to Import dialog, click the Browse button and navigate to the user directory that contains the settings you want to import. For more about the location of the NetBeans IDE userdir, see the FAQ What is a userdir and where can I find it?


Archived Modules and Features

The complete list of NetBeans Archived Features is available at


Known Issues


The unresolved installer issues for this release are as follows:

  • Issue #93568: On Linux, installation hangs when the network connection is lost.

    Description: On Linux platforms, if the network connection is lost, installation hangs when the installer is searching for a compatible JDK in network directories.

    Workaround: Restore the network connection and proceed with the installation.

  • Issue #117172: A blank window when running the installer on Ubuntu.

    Description: The installer appears as the blank/gray dialog when running on Ubuntu with Beryl/Compiz/Compiz Fusion installed.

    Workaround: Execute the export AWT_TOOLKIT=MToolkit command before running the installer.

  • Issue #123300: On Fedora Core 8 the installer stops displaying the interface and returns to the console.

    Description: On Fedora Core 8, displaying the installation interface stops and the system returns to the console.

    Workaround: See


Core IDE

The unresolved Core IDE issues for this release are as follows:

  • Characters do not display properly in some Asian locales.

    Description: When running the IDE with some Asian locales on Ubuntu and some other Linux distributions, the IDE's screen text may become unreadable. On certain Linux distributions multi-byte characters may display as a rectangle due to JDK font setting issues.

    Workaround: Please see the FAQ for help with resolving this issue:

  • Profiling application performance can fail when using the Advanced option.

    Description: The IDE displays the message "Redefinition failed with error 62" when attempting to profile application performance (CPU) and the Advanced (instrumented) option is selected.

    Workaround: Restart the application with the VM argument -Xverify:none to disable classfile verification. You must restart the application to disable classfile verification. You cannot disable verification if the application is running.

  • Issue #119617: Cursor lost in editor and cannot type using keyboard.

    Description: It can sometimes occur that after using a hint in the editor window that the insertion point in the editor disappears and you cannot type using the keyboard. This has mostly been reported on Mac OS X 10.4, but there have been some reports on some versions of Ubuntu.

    Workaround: Use the mouse to open and then close a dialog window (for example, a properties dialog). This returns the focus to the editor and the insertion point and keyboard will work as normal.

  • Issue #130357: I18N - OS X will not generate javadoc if the project name or path has multibyte characters.

    Description: The javadoc task is written in MacRoman, the default OS X encoding, when creating the temporary parameter file. This may be due to the BSD and Mach parts (system & kernel calls) accepting parameters in UTF-8, but the OS X and HFS only accepting MacRoman.

    Workaround: Avoid using multibyte characters in the name of the project or the path to the project.

  • Issue #200826: On Windows 7, newly installed IDE running on JDK 7 won't connect to network.

    Description: In some cases the firewall of the local system may filter responses from the network while connecting to a remote host. When connecting to a remote host the JDK will first attempt to use IPv6 and then IPv4. The firewall may filter out a negative response from the host when using IPv6 with the result that the JDK does not attempt to connect to the host using IPv4.

    Workaround: Modify the netbeans.conf to add the command line switch, or modify the NetBeans options of the environment variable.

  • Issue #207060: On Windows XP, UNC paths cannot be used as URIs.

    Description: On Windows XP, the automatic update of any file view (Project, Files, etc.) does not work when UNC style paths are used (for example, \\MyServer\myShare\myDirectory) instead of drive letters (for example, Y:\myDirectory).

    Workaround: Restart the IDE. Alternatively, choose Tools > Options > Miscellaneous > Files from the main menu, deselect the Enable auto-scanning of sources option, and select Refresh Folder in the context menu of a folder.

  • Issue #211406: Views and Palettes keeps scrolling itself to the drag position after drag-and-drop.

    Description: After dragging and dropping something from Projects or Files Views or Palette in GUI designers, when you scroll the View or Palette up or down it will scroll back to the drag position, requiring you to scroll to select some nodes and components.

    Workaround: You must restart the IDE.

  • Issue #215141: IDE on a Retina Macbook is very blurry.

    Description: The IDE appears blurry when viewed on a Retina display.

    Workaround: Run the IDE on the most recent update of JDK 7 or JDK 8.

  • Issue #231807: File chooser displays no file contents in the Open Project and Select Project Location dialog boxes.

    Description: On OS X, the file chooser is blank after File > Open Project is selected in the IDE or a folder for a new project location is selected in a new project wizard.

    Workaround: Disable the "Maximize Native Look and Feel" option.

  • Issue #236338: On OS X, the JVM might crash when running the IDE on JDK 7.

    Description: The JVM might crash on some machines that are running OS X and some versions of JDK 7. The crash might occur when you start NetBeans IDE, close the lid (or put the machine to sleep), wake the machine and attempt to work with the IDE.

    Workaround: Switch to JDK 7 update 40 or newer.

  • Issue #239962: Cannot connect to Derby DB when running IDE on JDK 7u51.

    Description: Security exception when trying to start Java DB from the IDE when running JDK 7u51.

    Workaround: Start Java DB manually from the command line with -noSecurityManager switch, for example <JDK 7u51 location>/db/bin/startNetworkServer -noSecurityManager . For details, see

  • Issue #256211: Test execution fails with Surefire 2.19.

    Description: When using Surefire 2.19, test execution is not performed and an error is shown that no tests are executed when running "test file" from the NetBeans IDE due to issue SUREFIRE-1191.

    Workaround: Use Surefire 2.18.


Java FX

The unresolved Java FX issue for this release is as follows:

  • Issue #239388: JavaFX projects configured to use JDK 7 cannot be run or debugged when the IDE is run on JDK 8.

    Description: On Windows 8, OS X, and Linux, JavaFX projects configured to use JDK 7 cannot be run or debugged when the IDE is run on JDK 8.

    Workaround: Use either of the following:

    • Start NetBeans with the --jdkhome switch pointing to JDK 7.
    • Set the netbeans_jdkhome property in <NetBeans Installation dir>/etc/netbeans.conf.
    • Note that when the IDE is run on JDK 7 you cannot build a JavaFX project for JDK 8 due to issue 255710.


Web and Java EE

The unresolved Web and Java EE issue for this release is as follows:

  • Issue #183614: Step Into does not work properly with EJB.

    Description: When debugging a servlet, Step Into an EJB call stops at unrelated code.

    Workaround: Set a breakpoint in the EJB implementation code and use Step Over.

  • Issue #246431: Cannot run Java Web application on Linux on WildFly.

    Description: Web application fails to run on WildFly server on Linux due to encrypted partition.

    Workaround: Right-click the WildFly server node in the Services window and select Edit Configuration. Add the <journal-type>NIO</journal-type> element directly below <hornetq-server> and restart the server.



The unresolved HTML5 issue for this release is as follows:

  • Issue #236967: Cordova projects may fail to build with Cordova 3.1.0.

    Description: Due to a Cordova issue the IDE might replace the old version of a plugin with a newer one, which can result in dependent plugins being removed and the Cordova project failing to build.

    Workaround: Perform the following steps:

    1. Remove core from the Cordova plugin name in the plugin properties file ([projectFolder]/nbproject/
      (for example, changing to
    2. Delete contents of the [projectFolder]/platforms and [projectFolder]/plugins folders.
    3. Rebuild the project.



The unresolved PHP issue for this release is as follows:

  • Issue #201449: FTP and SFTP do not work with Java 7 on Windows 7 or Vista.

    Description: Windows 7 or Windows Vista users running the NetBeans IDE on JDK 7 may experience FTP and SFTP communication failure.

    Workaround: Check Windows Firewall. Windows Firewall blocks some FTP and SFTP operations launched by JDK 7. See NetBeans Configuring Windows Firewall For Passive FTP User FAQ for details.



NetBeans C/C++ support C, C++, Fortran and various Assemblers (x86, SPARC, etc.) applications on Microsoft Windows, Macintosh OS X, and Linux. C/C++ developers can bring existing applications into the NetBeans project system, or develop new applications and libraries. NetBeans C/C++ support covers the end-to-end development cycle: projects and templates, an advanced language-aware editor, makefile-based builds, and debugging.

The unresolved C/C++ issues for this release are as follows:

  • Issue #200196: On some Linux platforms, "Step Over" sometimes behaves as "Continue".

    Description: On some Linux platforms (Ubuntu, Debian, etc.), "Step Over" sometimes behaves as "Continue" when versions of GDB are equal to 7.2 or lie within the range of 7.2 to 8.0.

    Workaround: Use GDB versions earlier than 7.2, or GDB 7.4 and more recent, or specify "Console Type" (Project Properties > Run) to another option in the Terminal window.

  • Issue #225920: On Linux, C makefile build fails with the "Permission denied" error, if the tmp directory has no execution permission.

    Description: On Linux, C makefile build fails with the "Permission denied" error, if the tmp directory has no execution permission.

    Workaround: Set the execution permission to the tmp directory or run the IDE with the<path_to_new_tmp_dir> option to redefine the tmp directory.

  • Issue #234221: On Windows 32-bit, the IDE (and 32-bit version of JDK) does not work with the 64-bit version of Cygwin and vice versa.

    Description: On the 32-bit version of Windows, the IDE (and 32-bit version of JDK) does not work with the 64-bit version of Cygwin and vice versa

    Workaround: Install and use the IDE, JDK, and Cygwin with the matching bitness (for example, all the three software components need to be 32-bit).

  • Issue #235406: On Windows, the IDE displays the contents of the Terminal window with low contrast.

    Description: On Windows, the IDE displays the contents of the Terminal window with low contrast.

    Workaround: Set the PS1 environment variable in the Cygwin <home_dir>/.bashrc file to another value.

More Information

You can find news, articles, additional modules, and other useful information on the NetBeans project web site. Since NetBeans is an open-source project, the web site also provides access to source code, a bug database, information on creating your own NetBeans modules, and much more. For more information, visit


To get the most out of the features in NetBeans IDE 8.1, check out our web-based tutorials at the NetBeans IDE Documentation page.

Additional reference documentation resources include:

  • The NetBeans User FAQ has many workarounds and troubleshooting tips not included in the Release Notes.
  • The IDE's built-in help system has detailed support information for features included in all of the NetBeans IDE modules.
  • See Using NetBeans IDE on OS X for information about keyboard equivalents, tips, tricks, and other OS X-specific topics.
  • See NetBeans 8.1 Online Documentation Library for information on how to use the NetBeans IDE and detailed information on the functionality available within it.


Keep up to date on the the latest developments and interact with the NetBeans community by signing up for NetBeans project mailing lists at

You can post questions at The forums are synchronized with the most widely used NetBeans mailing lists. Note that a separate sign up for the forums is required.

Please visit the community translation information page at to learn how to contribute to additional language localizations of the NetBeans UI, help and user documentation.


Not logged in. Log in, Register