Getting Started with iReport Designer

What is iReport?

iReport is a powerful graphical design tool for report designers and power users to define reports for execution using the JasperReports engine. Whether you are using the JasperReports library by itself as a critical component of your application or you are using it as a component of the JasperReports Server application, iReport can help you design reports to meet the most complex reporting demands. iReport is built on the NetBeans platform and is available as a standalone application or as a Netbeans plug-in. 

System Requirements

For current requirements, please check the iReport documentation and release notes. It is recommended that you run iReport with JDK v1.5 or v1.6. Note that for Windows Vista users, it is recommended that you run JDK v1.6.

iReport/Jaspersoft Studio Support Announcement
As of version 5.5.0, Jaspersoft Studio will be the official design client for JasperReports. iReport will remain as a supported product in maintenance-only mode until December 31, 2015, meaning we will continue to fix critical defects in upcoming releases but no new features will be added to the iReport client. Continue to maintain your existing reports with the new Jaspersoft Studio!


There are 4 ways to install iReport:

  • Bundled with JasperReports Server (For those with developers working directly on the server)
  • Windows Binary Installer
  • Platform Independent Zip Archive
  • NetBeans plug-in (Community Edition only)

Windows Binary Installation

iReport provides a convenient Windows installer created using NSIS, the popular installer from Nullsoft ( To install iReport, double-click iReport-nb-x.x.x-windows-installer.exe.

At the end of the installation process, you get a new menu item in the Program files menu (Program files → JasperSoft → iReport-nb-x.x.x).

You can have more than one version of iReport installed on your machine at the same time, but all these versions will share the same configuration files.

The installer creates a shortcut to launch iReport, linking the shortcut to iReport.exe (present in the bin directory under the program home directory).

Platform Independent Zip Archive Installation

Unpack the distribution archive into the directory of your choice, for example, c:\devel (or /usr/devel on a UNIX system).

Open a command prompt or a shell, go to the directory where the archive was unpacked, go to the iReport directory, then to the bin subdirectory and enter:


For a Unix system, enter:

root> ./ireport

(In this case, you must configure the installation script to be executable with a chmod +x command.)


Adding a Data Source

Relational database is the most common datasource. iReport provides the JDBC driver for the following SQL-compliant database systems:

  • MySQL
  • PostgreSQL
  • HSQL

See iReport - Adding a Data Source. For others relational databases, see Connecting iReport to other datasources.

Connecting to JasperServer (iReport Pro only)

See iReport - Connecting to JasperReports Server.

Optional Configurations

Using iReport

See Also...

For additional information, see the following resources: