Visit Azul.com Support

IcedTea-Web Usage Instructions

Table of Contents
Need help?
Schedule a consultation with an Azul performance expert.
Contact Us

Validate Installation on Windows

Java 8 or 11

Make sure you have Java 8 or 11 installed.

 
C:\>java -version
openjdk version "11.0.21" 2023-10-17 LTS
OpenJDK Runtime Environment Zulu11.68+17-CA (build 11.0.21+9-LTS)
OpenJDK 64-Bit Server VM Zulu11.68+17-CA (build 11.0.21+9-LTS, mixed mode)

JAVA_HOME

Check that the JAVA_HOME variable has been defined and points to the correct location of the Java installation.

 
C:\>echo %JAVA_HOME%
C:\Program Files\Zulu\zulu-11\

IcedTea-Web in PATH variable

Check that the IcedTea-Web directory has been added to a PATH variable.

 
C:\>echo %PATH%
C:\Program Files\Zulu\zulu-11\bin\;C:\Program Files\IcedTeaWeb\WebStart\bin;C:\Windows\system32;C:\Windows;...

How to Start a WebStart application with IcedTea-Web

In modern browsers, a JNLP-file will be downloaded and saved to downloads folder, and can’t be opened in the browser.

Once a JNLP-file has been downloaded, you can start it in several ways:

  • Open the Downloads directory and double-click on the JNLP-file.

    • This will only work if there is an association between the .jnlp extension and the javaws.exe binary.

  • Start a JNLP-file from the command line:

     
    C:\Users\YourName\Downloads>javaws application.jnlp

  • Use the full installation path of javaws.exe:

     
    C:\Users\YourName\Downloads>"C:\Program Files\IcedTeaWeb\WebStart\bin\javaws.exe" application.jnlp

Additional Tools

A few other tools are provided with IcedTea-Web.

Web Control Panel

itweb-settings: allows to view and modify the settings for javaws and the browser plugin.

 
C:\>itweb-settings
web control panel

PolicyEditor

policyeditor: allows end-users to quickly and easily view or edit the contents of their applet policy.

 
C:\>policyeditor
policy editor

How Iced-Tea-Web is Locating the Java Runtime

javaws.exe needs a valid Java Runtime, and it will search for this runtime in the following order, until it finds it:

  1. Check deployment.properties for the deployment.jre.dir property.

  2. Check the JAVA_HOME environmental variable.

  3. Check if there is an embedded Java Runtime with IcedTea-Web.

  4. Check Windows registry keys.

  5. Check if there is a Java Runtime in the PATH variable.