Installation Requirements

Before installing the product on your system, ensure that you can log in to the system with appropriate permissions, and that your system meets the hardware and software requirements needed to install JasperReports Server. See the JasperReports Server Supported Platform Datasheet for more information.

Installing JasperReports Server automatically generates encryption keys and encrypts passwords that reside on the file system. These keys are stored in a dedicated TIBCO Jaspersoft keystore. Make sure this keystore is properly secured and backed up. For more information, refer to the JasperReports Server Security Guide.

Pre-installation Tasks

Pre-installation tasks include the tasks that you must complete before you start the installer, such as ensuring your system meets the installation requirements. If you want to use existing versions of any component software, you must also prepare them, as described in later sections.

Download JasperReports Server Software

Download the JasperReports Server software package for your platform from the Download section of the Jaspersoft Community website. Extract the JasperReports Server archive file to a temporary directory on the machine on which you will run the installer.

The installers have the following file names:


Installation Account

The privileges required to install the product differ for Windows and UNIX platforms. Ensure that you have the appropriate privileges to install on the target platform.

Microsoft Windows

You must have administrator privileges for the machine on which you want to install the software. Right-click the binary installer file and select “Run as administrator” from the context menu.

The Windows installer will get an error installing the PostgreSQL database if the Windows user does not have sufficient administrative privileges and if the installer is not started by right-clicking to use “Run as administrator”.


In Linux, the installer is a .run file; you can run it from the command line or from a graphical environment. Any non-root user can perform the installation.


In Mac OSX, the installer is a .zip file. After download, you should find the installer already unpacked in your <user>/Downloads folder. Double-click the following: