web start

Java Web Start – Getting Started

In this tutorial, we will introduce you to the concepts of the Java Web Start technology. The Java Web Start software allows you to download and run Java applications from the web. It is included in the Java Runtime Environment (JRE) since release of Java 5.0 and:

  • Provides an easy, one-click activation of applications
  • Guarantees that you are always running the latest version of the application
  • Eliminates complicated installation or upgrade procedures


The Java Web Start software is launched automatically, when a Java application using Java Web Start technology is downloaded for the first time. The Java Web Start software caches the entire application locally on your computer. Thus, any subsequent launches are being executed directly from the local cache. Every time you start the application, the Java Web Start software component checks the application’s website to see if a new version is available, and if so, automatically downloads and launches it.

In this example, we use the following tools on a Windows 7 platform:

  • Eclipse Kepler Service Release 1
  • Apache Tomcat 7
  • JDK 1.7

Deploying Java Web Start Applications

Java Web Start is an implementation of the Java Network Launching Protocol (JNLP) specification. Java Web Start works by using a special file called the JNLP descriptor, which is a small XML document that contains elements and attributes that tell Java Web Start how to run the application. That JNLP file instructs Java Web Start software to download, cache, and run the application.

In order to create and deploy an application, we must undergo the following steps:

  • Create a simple application and package it into a .jar file.
  • Sign the newly created .jar file.
  • Create the .jnlp file of our application.
  • Place all files inside a Web Server, such as Apache Tomcat 7.
  • Access, download and execute our created .jar file from the web.

First of all, we need to develop an application and package it into a .jar file. A sample example is shown below:


package main.javacodegeeks;

import javax.swing.JFrame;
import javax.swing.JLabel;

public class JNLPExample extends JFrame {

     private static final long serialVersionUID = 4968624166243565348L;
     private JLabel label = new JLabel("Hello from Java Code Geeks!");

     public JNLPExample() {
          super("Jave Web Start Example");
          this.setSize(350, 200);

     public void addButtons() {
          label.setSize(200, 30);
          label.setLocation(80, 50);

     public static void main(String[] args) {
          JNLPExample exp = new JNLPExample();

In this sample application, we create a JFrame and we place a JLabel with a text message in its center. Then, using the command prompt, we navigate to the folder where our project is located and we execute the following command:

jar -cf JNLPExample.jar *.*

This command packages our application into an executable .jar file, called JNLPExample.jar. Then, we execute the following two commands, in order to create a keystore and sign our executable .jar file with it:

keytool -genkey -keystore testkeys -alias stathis
jarsigner -keystore testkeys JNLPExample.jar stathis

Important: Be sure that you answer all the required questions that may pop up when you execute the 1st command.

Then, we create our .jnlp file of our application. A sample example of a JNLP file is shown below:


<?xml version="1.0" encoding="utf-8"?>
<jnlp spec="1.0+" codebase="http://localhost:8080/" href="JNLPExample.jnlp">

          <title>JNLP Example</title>
          <vendor>Java Code Geeks</vendor>
          <homepage href="http://localhost:8080/" />
          <description>JNLP Testing</description>


          <j2se version="1.6+" />
          <jar href="JNLPExample.jar" />

     <application-desc main-class="main.javacodegeeks.JNLPExample" />

In the above code snippet, inside the jnlp element, we have two attributes, one for the href of the jnlp itself and one for the codebase, which denotes where the .jar files and all other resources will be downloaded from. Inside the jnlp element are three sections:

  • Information
  • Security
  • Resources
  • Application’s description

The Information section has purely descriptive content and may contain other things like icons, a splash screen, or longer descriptions. Inside the Security section, we define which user can execute the application. The resources section tells Java Web Start which .jar files and other resources are required, in order for our program to be executed. The resources section can also contain native libraries, extensions, properties, and other elements, but the .jar files are the most important. The last section, application-desc, specifies some attributes about the application. In this case, we define that the main class of our application resides in the com.javacodegeeks.JNLPExample class.

A full list of all elements and attributes of a JNLP file can be found in the Java Network Launching Protocol API Specification (JSR-56). Also, the Java Web Start supports the encoding of JNLP files in any character encoding supported by the Java platform. For more information on character encoding in Java, see the Supported Encodings Guide.

The next step is to copy all the application’s .jar files, the JNLP file and all necessary resources in a Web server. We must ensure that the .jar files are copied in the locations specified by the href attribute inside the JNLP file.

We copy both the JNLPExample.jar and JNLPExample.jnlp files to Apache Tomcat, inside the following folder:

and launch the Apache Tomcat from the Windows command line, using the command:


Access the following URL:

in order to download and execute our newly created application. If all steps are executed successfully and assuming that Java Web Start is installed on the client’s computer, you shall see the following screen:


Check the I accept the risk and want to run this application choice and click on Run. The following window shall appear:


For those users who might not have Java Web Start installed, you may write scripts in your Web page that:

  1. Detect which browser the user has.
  2. Detect whether Java Web Start is installed.
  3. If Java Web Start is not installed, either auto-install it, or direct the user to a download page.

Pack200 Compression

Sun Microsystems introduced a compression system called Pack200 in Java 1.5.0, in order to reduce the size of a Java Web Start application. Pack200 compresses large files very efficiently, depending on the density and size of the class files in the .jar file.

Methods to Launch an Application

An application that uses the Java Web Start technology can be launched using one of the following methods:

  • From a browser.
  • From a desktop icon: If you use an application frequently, you can create a shortcut on your personal computer.
  • From command prompt or terminal: You can launch an application from a command prompt or terminal, by typing:
    javaws <URL>

    where URL points to the .jnlp file of the application.

  • From Java Cache Viewer: Java Web Start provides a Cache Viewer, which can be launched from the Java Control Panel. The Cache Viewer enables the user to directly launch a downloaded application.

Launch an application using the Java Cache Viewer

    1. Open the Windows Control Panel.
    2. In the Control Panel Search area, enter Java Control Panel.
    3. Click on the Java icon that appears, in order to open the Java Control Panel.

If all steps were executed properly, you should see the following window:


    1. Click on the View… button from the Temporary Internet Files section. The Java Cache Viewer will pop up.
    2. Double click on the specific application that you want to launch.

Delete temporary files from the Java Cache Viewer

  1. Inside the Java Control Panel, click on the Settings… button from the Temporary Internet Files section. The Temporary Files Settings dialog box appears:


  2. Click on the Delete Files… button. The Delete Files and Applications dialog box appears:


  3. Click OK on the Delete Files and Applications dialog. This deletes all the downloaded applications and applets from the cache.
  4. Close the Temporary Files Settings dialog.

Delete a specific application or applet from the Java Cache Viewer

  1. Inside the Java Control Panel, click on the View… button from the Temporary Internet Files section.
  2. Choose your application, press right click on it and then, click on Delete.

This was a tutorial on how to use the Java Web Start technology.

Sotirios-Efstathios Maneas

Sotirios-Efstathios (Stathis) Maneas is a PhD student at the Department of Computer Science at the University of Toronto. His main interests include distributed systems, storage systems, file systems, and operating systems.
Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Newest Most Voted
Inline Feedbacks
View all comments
gaurav dubey
gaurav dubey
5 years ago

hi. i am getting this exception.
reason: your security settings have blocked a self-signed application from running.
please help me as it is urgent.

5 years ago
Reply to  gaurav dubey

use java 7 of 32 bit version and set security level in java as medium,,then try

Amine Mezian
Amine Mezian
4 years ago
Reply to  gaurav dubey

In the Java settings in Windows control panel, add the url to the JNLP file to the list of exceptions (security tab). It should work

Ditlhake Matshube
Ditlhake Matshube
5 years ago

Good day
I am new to java, but i am getting this error when i run this error: main.javacodegeeks.JNLPExample

I suspect the problem is on the JNLP’s application-desc


Back to top button