Installing in GUI Mode

When you run the installer in GUI mode, the installer presents panels that you can use to choose the installation environment and customize your installation.

Steps for all installations:

1. Run the installer executable. On Windows, make sure to right-click the binary installer file and select Run as administrator from the context menu.
     On Microsoft Windows: TIB_js-jrs-cp_7.5.0_win_x86_64.exe
     On Unix:
     On Mac OS:
2. On the welcome screen, click Next.
3. To accept the license agreement, click I accept the agreement then click Next.
4. Select the installation type you want, then click Next.
     Install All Components and Samples installs all components and samples.
     Custom Install lets you choose some pre-installed and some bundled components. Make sure you have installed supported versions of the components you want. If you are using a pre-installed Tomcat, make sure it is stopped. If you are using an existing PostgreSQL instance, it must be running during install. See the JasperReports Server Supported Platforms Datasheet for information about supported versions.
5. Select an installation path, then click Next. The default <js-install> directory depends on your operating system:





Linux (as root)




On Linux, choose a <js-install> path that’s no more than 84 characters.

If you chose Install All Components and Samples, installation begins.

Additional steps for custom install:

6. If you selected Custom Install, choose your components:
     Select the bundled or an existing Tomcat, then click Next.
     Select the bundled or an existing PostgreSQL database, then click Next. If you select an existing database, a warning popup will appear. Click Yes to continue.
     Select the bundled PhantomJS, an existing PhantomJS, or select to use Rhino for rendering. Then click Next.
7. Enter your Tomcat ports, which may include server port, shutdown port, and AJP port. Then click Next.
8. Enter your database server port and click Next.
9. If you selected an existing Tomcat, specify your Tomcat directory and click Next.
10. If you selected an existing PostgreSQL, specify your PostgreSQL directory and click Next.
11. If you selected an existing PhantomJS, specify your PhantomJS directory and click Next.
12. When you are prompted, choose whether or not to install sample databases and reports. Then click Next.
13. Click Next to begin the installation.

JasperReports Server and any selected bundled components are installed on your system.

Finalizing the installation:

14. Make your post-install selections on the final screen:
     Launch JasperReports Server Login Page - If you selected both bundled Tomcat and PostgreSQL, you will see an option Launch JasperReports Server Login Page. If you’re installing on Linux, don't close the terminal window running the start script.

If you choose not to Launch JasperReports Server Now, the bundled components won't be started. If you have only one bundled component, it won't be started unless you use the Start/Stop menus or scripts.

     Opt-in for JasperServer Heartbeat - Sends anonymous system and version information to Jaspersoft using HTTPS.
15. Click Finish to complete the installation process, and close the installer window.

Installing Using the Command Line

In Linux, the installer is a .run file; you can run it from the command line or from a graphical environment. To start the installer from the command line, open a bash shell, and enter the name of the installer file. For example:


Whether you run the installer from the command line or in a graphical environment, you'll be prompted for the same information. If you're installing from the command line, use your keyboard to specify your answers. For example, with the license text, instead of clicking I accept the agreement, press Y and press Enter.