Scroll to navigation

javaws(1) General Commands Manual javaws(1)

NAME

javaws - a Web Start client

SYNOPSIS

javaws [-run-options] jnlp file
javaws [-control-options]

DESCRIPTION

javaws is an implementation of a JNLP client. It uses a JNLP file to securely run a remote application or an applet. This implementation of javaws is from the IcedTea project and is based on the NetX project.

A JNLP file is an xml file that describes how to securely run a remote application or an applet.

Missing Resource: manCommandLineOptions_en

When specifying options, the name of the jnlp file can be after the command, the -jnlp option, an option with no arguments, or after an argument with an option that takes one argument. A html file that launches a jnlp can be specified after the -html option.
The jnlp-file can either be a url or a local path.
The JNLP file should only be specified once, whether as a main argument, after -jnlp or through an html file.

Control options:

Shows a sample application.(No argument expected)
Prints out information about supported command and basic usage.(No argument expected)
Display the GPL license and exit.(No argument expected)
Shows the trusted certificate viewer.(No argument expected)
List available IDs in cache, which you can use to delete individual applications.(Expected none or one argument)
Clean the JNLP application cache. If you pass argument, only specified application is deleted.(Expected none or one argument)

Run options:

Follows HTTP redirects.(No argument expected)
Adds an application argument before launching.(Expected one or more arguments)
Launch embedded browser. Use in great need only!(Expected one or more arguments)
Disables download window, other UIs.(No argument expected)
Location of JNLP file to launch (url or file).(Exactly one argument expected)
Disables the secure runtime environment. You need also deployment.security.itw.ignorecertissues to workaround corrupted signatures(No argument expected)
Disables checking for updates.(No argument expected)
Adds an applet parameter before launching.(Expected one or more arguments)
Sets a system property before launching.(Expected one or more arguments)
Enables strict checking of JNLP file format.(No argument expected)
Check for updates.(Exactly one argument expected)
Enable verbose output.(No argument expected)
Print the IcedTea-Web version and exit.(No argument expected)
Skip jar header verification.(No argument expected)
Uses a strict XML parser to parse the JNLP file.(No argument expected)
Do not create another JVM.(No argument expected)
Do not show splash screen. (No argument expected)
Prevent ITW network connection. Only cache will be used. Application can still connect.(No argument expected)
Instead of asking user, will answer all questions with no.(No argument expected)

EXAMPLES

Shows basic help and about informations.
Shows basic help and about informations in terminal only.
http://mypage.web/dangerous.jnlp
Will start dangerous.jnlp application, originally from mypage.web, without downloading it, without headers check and in forced single VM.

FILES

$JAVA_HOME/lib/deployment.config
JVM-global deployment properties file. May be affected by deployment.jre.dir.
$JAVA_HOME/lib/security/cacerts
Contains various system JVM-wide stored certificates. Controlled by deployment.system.security.cacerts

$JAVA_HOME/lib/security/jssecacerts
Contains various system JVM-wide stored certificates. Controlled by deployment.system.security.jssecacerts

$JAVA_HOME/lib/security/trusted.certs
Contains various system JVM-wide stored certificates. Controlled by deployment.system.security.trusted.certs

$JAVA_HOME/lib/security/trusted.clientcerts
Contains various system JVM-wide stored certificates. Controlled by deployment.system.security.trusted.clientautcerts

$JAVA_HOME/lib/security/trusted.jssecerts
Contains various system JVM-wide stored certificates. Controlled by deployment.system.security.trusted.jssecerts

$TMP/$USER/netx/locks
Location of netx locks. Controlled by deployment.user.locksdir

$TMP/$USER/netx/locks/netx_running
Location of netx main lock. Controlled by deployment.user.runningfile

$XDG_CACHE_HOME/icedtea-web/cache
Contains cached runtime entries. Controlled by deployment.user.cachedir

$XDG_CACHE_HOME/icedtea-web/cache/recently_used.cache
Additional information about items in cache
$XDG_CACHE_HOME/icedtea-web/pcache
Contains saved application data. Controlled by deployment.user.pcachedir

$XDG_CACHE_HOME/icedtea-web/tmp
Contains temporary runtime files. Controlled by deployment.user.tmp

$XDG_CONFIG_HOME/icedtea-web/.appletTrustSettings
File responsible for various actions on applets and apps based on their codebase based on users actions.
$XDG_CONFIG_HOME/icedtea-web/deployment.properties
Users main deployment properties file.
$XDG_CONFIG_HOME/icedtea-web/icons
Location where icons of javaws applications desktop/menu launchers icons are stored
$XDG_CONFIG_HOME/icedtea-web/log
contains file-log files (if enabled), itw-cplugin-date_time.log for native part of plugin, itw-javantx-date_time.log for everything else. Controlled by deployment.user.logdir

$XDG_CONFIG_HOME/icedtea-web/security/java.policy
Contains granted permissions for selected unsigned apps. Controlled by deployment.user.security.policy

$XDG_CONFIG_HOME/icedtea-web/security/trusted.cacerts
Contains various users stored certificates. Controlled by deployment.user.security.trusted.cacerts

$XDG_CONFIG_HOME/icedtea-web/security/trusted.certs
Contains various users stored certificates. Controlled by deployment.user.security.trusted.certs

$XDG_CONFIG_HOME/icedtea-web/security/trusted.clientcerts
Contains various users stored certificates. Controlled by deployment.user.security.trusted.clientauthcerts

$XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecacerts
Contains various users stored certificates. Controlled by deployment.user.security.trusted.jssecacerts

$XDG_CONFIG_HOME/icedtea-web/security/trusted.jssecerts
Contains various users stored certificates. Controlled by deployment.user.security.trusted.jssecerts

$XDG_DATA_HOME/applications/javaws
Subdirectory in users menus space, for placing custom menu shortcuts.
{%WINDIR/Sun/Java or /etc/.java}/deployment/.appletTrustSettings
File responsible for various actions on applets and apps based on their codebase based on admins actions.
{%WINDIR/Sun/Java or /etc/.java}/deployment/deployment.config
Global deployment config file.
{%WINDIR/Sun/Java or /etc/.java}/deployment/itw-deployment.config
Global deployment config file.

Where $XDG_CONFIG_DIR, $XDG_CACHE_DIR and $XDG_RUNTIME_DIR are set as ~/.config, ~/.cache and /tmp or /var/tmp if not set.

BUGS

There aren't any known bugs. If you come across one, please file it at:
http://icedtea.classpath.org/wiki/IcedTea-Web#Filing_bugs
https://github.com/AdoptOpenJDK/icedtea-web/issues

Please run in debug (-verbose switch or itw-settings setting or ICEDTEAPLUGIN_DEBUG variable set to true) mode and include that output (best is from the console) with URL to jnlp or html file (or the jnlp/html file or application itself) when filling out the bug report.

AUTHOR

https://github.com/AdoptOpenJDK/icedtea-web/graphs/contributors

SEE ALSO

icedtea-web(1) javaws(1) icedtea-web-plugin(1) itweb-settings(1) policyeditor(1) policytool(1) java(1)

https://github.com/AdoptOpenJDK/icedtea-web
https://github.com/AdoptOpenJDK/icedtea-web.git

14 Oct 2026 icedtea-web 2.0.0-alpha36