How to install OpenWebStart

How to install OpenWebStart

OpenWebStart 1.0.0 comes with a user-friendly installer. Download the latest stable build to try out the OpenWebStart pre-release now!

OpenWebStart is released under the GPL mit Classpath Exception license.

How to Install OpenWebStart on Microsoft Windows

  1. Go to the download area and download OpenWebStart_windows-x64_1_0_0.zip.
  2. Run the installer.
  3. Choose a language and click OK to open the OpenWebStart Setup wizard.
  4. Click Next to start the OpenWebStart installation.
  5. Browse to the directory where to install OpenWebStart, and click Next.
    Windows default: C:\Program Files\OpenWebStart
  6. Enable the checkbox to associate the .JNLP suffix with OpenWebStart, and click Next.
  7. Wait while Setup installs OpenWebStart on your computer.
  8. Click Finish on the completion screen to close the wizard.

How to Install OpenWebStart on Linux

  1. Go to the download area and download OpenWebStart_linux_1_0_0.deb.
  2. Change into the installer directory and run the installer from the terminal:
    sudo dpkg -i OpenWebStart_linux_0_5_x.deb
  3. Enter your root password.
  4. Choose a language and click OK to open the OpenWebStart Setup wizard.
  5. Click Next to start the OpenWebStart installation.
  6. Browse to the directory where to install OpenWebStart, and click Next.
    Default: /opt/openwebstart
  7. Enable the checkbox to associate the .JNLP suffix with OpenWebStart, and click Next.
  8. Please wait for OpenWebStart to be installed on your computer.
  9. Click Finish on the completion screen to close the wizard.

How to Install OpenWebStart on macOS

  1. Go to the download area and download OpenWebStart_macos_1_0_0.dmg.
  2. Open the OpenWebStart disk image (DMG file) to mount it.
  3. Run the Open Web Start Installer.app.
  4. Choose a language and click OK to open the OpenWebStart Setup wizard.
  5. Click Next to start the OpenWebStart installation.
  6. Browse to the directory where to install OpenWebStart, and click Next.
    Default: /Applications/Open Web Start
  7. Enable the checkbox to associate the .JNLP suffix with OpenWebStart, and click Next.
  8. Please wait for OpenWebStart to be installed on your computer.
  9. Click Finish on the completion screen to close the wizard.

How to Use OpenWebStart

OpenWebStart installs an executable called javaws that can run Java Web Start apps (.JNLP suffix).

To run .JNLP applications with OpenWebStart, double-click to open them as usual.

Alternatively, you can run any webstart app myApp.jnlp with OpenWebStart from the command line or terminal:

  • Windows Command Line
    C:\Program Files\OpenWebStart\javaws -jnlp myApp.jnlp -console
  • Linux Terminal
    /opt/openwebstart/javaws -jnlp myApp.jnlp

Note: If you have an existing Oracle javaws executable associated with your .JNLP applications, you need to change the file association for the .jnlp suffix.

How to change the JNLP file association from Oracle javaws to OpenWebStart javaws

During the development phase, the OpenWebStart installer will not change file associations of any existing Oracle javaws executable, so you can use both.

To associate .JNLP applications with OpenWebStart in Windows Explorer:

  1. Right-click the JNLP app and select Open With -> Choose Another App.
  2. Click More Apps and scroll down.
  3. Click Look for Another App on this PC.
  4. Browse to OpenWebStart at C:\Program Files\OpenWebStart\javaws.
  5. Click Open to associate this JNLP file with OpenWebStart.

To associate .JNLP applications with OpenWebStart in the macOS Finder:

  1. Right-click the JNLP app and select Open With -> Other….
  2. Browse to OpenWebStart at /Applications/Open Web Start/javaws.
  3. Click Open to associate this JNLP file with OpenWebStart.

How to perform an unattended installation

  1. Install OpenWebStart for your operating system as described in this article.
    The installer creates a response file that stores the options that you have chosen in the installer.
  2. Locate the response file and copy it next to the OpenWebStart installer:
    • For Windows: C:\Program Files\OpenWebStart\.install4j\response.varfile
    • For macOS: /Applications/Open Web Start/.install4j/response.varfile
  3. Run the installer again from the command line with the parameter -q -varfile response.varfile to execute an unattended installation.
    • For Windows: OpenWebStart_windows_Setup.exe -q -varfile response.varfile
    • For macOS: sudo Open\ Web\ Start\ Installer.app -q -varfile response.varfile

When using the unattended installation several configuration properties can be defined in the response.varfile file. You can find an overview of the supported properties here.

How to Uninstall OpenWebStart

For Windos and macOS:

  1. Go to your OpenWebStart directory.
  2. Run the Uninstaller.
  3. Click Next in the OpenWebStart Uninstaller wizard.
  4. Wait for the Uninstaller to complete.
  5. Click Finish on the completion screen to close the wizard.

For Linux:

  1. Use your package manager and remove the package OpenWebStart

Auto Update functionality for OpenWebStart

Once OpenWebStart is installed it will automatically check for new versions of OpenWebStart. If a new version is found a dialog will inform the user about the new version and provides the possibility to directly download and install the update.

If you do not want to use the auto update functionality it can be deactivated by using the unattended installer. You can find information about such configuration here.