--- name: "itweb-settings" section: "1" platform: "linux" package: "icedtea-web" version: "1.8.8-1" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/itweb-settings" --- # itweb-settings(1) view and modify settings for javaws and the browser plugin ## NAME itweb-settings - view and modify settings for **javaws** and the **browser plugin** ## SYNOPSIS **itweb-settings**\ **itweb-settings** command arguments ## DESCRIPTION **itweb-settings** is a command line and a GUI program to modify and edit settings used by the IcedTea-Web implementation of **javaws** and the **browser plugin**\ If executed without any arguments, it starts up a GUI. Otherwise, it tries to do what is specified in the argument.\ The command-line allows quickly searching, making a copy of and modifying specific settings without having to hunt through a UI. ## DESCRIPTION - \-check name Checks that all the current settings have valid values.(No argument expected) - \-get name Shows the value of the specified settings.(Expected one or more arguments) - \-headless Disables download window, other UIs.(No argument expected) - \-help Prints out information about supported command and basic usage. Can also take an parameter, and then it prints detailed help for this command.(No argument expected) - \-info name Shows additional information about the named settings. Includes a description, the current value, the possible values, and the source of the setting.(Expected one or more arguments) - \-list Shows a list of all the IcedTea-Web settings and their current values.(No argument expected) - \-reset name Resets the specified settings to their original value.(Expected one or more arguments) - \-reset all Resets all settings to their original values.(No argument expected) - \-set name value Sets the settings to the new value specified, if it is an appropriate value.(Expected even number of arguments with param=value as valid argument) - \-verbose Enable verbose output.(No argument expected) ## EXAMPLES - itweb-settings Show the GUI editor - itweb-settings -reset deployment.proxy.type Resets the value of \`deployment.proxy.type\` setting. **Known properties (key and default value):** - deployment.background.threads.count 3 (Possible: are in range 1 to 16 (inclusive)) - deployment.browser.path null (Possible: Set path to browser or any command launching url. If not set, default browser is used. If default browser is not available, you will be be prompted to provide URL consumer. Eg: firefox, or (windows) rundll32 url.dll,FileProtocolHandler , microsoft-edge, (mac) safari, xdg-open (linux) like commands. In headless mode you can use wget, curl or lynx. It can be also javaws itself to launch other jnlp. You can set yor custom browser via deployment.browser.path property. $BROWSER environment variable is serving same purpose. You can use keyword INTERNAL-HTML to launch internal browser. But be warned, it is terrible. Use ALWAYS-ASK to enforce prompt each time instead of using defaults.) - deployment.cache.jarcompression 0 (Possible: are in range 0 to 10 (inclusive)) - deployment.cache.max.size \-1 (Possible: are in range -1 to 2,147,483,647 (inclusive)) - deployment.console.startup.mode HIDE (Possible: \[DISABLE, HIDE, SHOW, SHOW\_PLUGIN\_ONLY, SHOW\_JAVAWS\_ONLY\]) - deployment.enable.cache.fsync false (Possible: are true or false) - deployment.headless.ignore false (Possible: are true or false) - deployment.https.noenforce false (Possible: are true or false) - deployment.javapi.cache.enabled false (Possible: are true or false) - deployment.javaws.associations 2 (Possible: are in range 0 to 3 (inclusive)) - deployment.javaws.autodownload false (Possible: are true or false) - deployment.javaws.installURL null (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/)) - deployment.javaws.shortcut ASK\_IF\_HINTED (Possible: \[ALWAYS, ALWAYS\_IF\_HINTED, ASK\_USER, ASK\_IF\_HINTED, NEVER\]) - deployment.javaws.update.timeout 500 (Possible: are in range 0 to 10,000 (inclusive)) - deployment.jnlpclassloader.strict true (Possible: are true or false) - deployment.jre.dir null - deployment.launcher.rust.bootcp.add null (Possible: Rust native launchers only! CP and XBootCP properties are space separated members of bootcp/cp to be removed or added. eg \`...cp.add=/usr/java/rhino.jar /usr/java/scary.jar\` will add those two jars to cp. Eg: \`...bootcp.remove=rhino.jar tagsoup.jar\` will remove those two jars no meter of path. Removal is done first.) - deployment.launcher.rust.bootcp.remove (Possible: Rust native launchers only! CP and XBootCP properties are space separated members of bootcp/cp to be removed or added. eg \`...cp.add=/usr/java/rhino.jar /usr/java/scary.jar\` will add those two jars to cp. Eg: \`...bootcp.remove=rhino.jar tagsoup.jar\` will remove those two jars no meter of path. Removal is done first.) - deployment.launcher.rust.cp.add (Possible: Rust native launchers only! CP and XBootCP properties are space separated members of bootcp/cp to be removed or added. eg \`...cp.add=/usr/java/rhino.jar /usr/java/scary.jar\` will add those two jars to cp. Eg: \`...bootcp.remove=rhino.jar tagsoup.jar\` will remove those two jars no meter of path. Removal is done first.) - deployment.launcher.rust.cp.remove (Possible: Rust native launchers only! CP and XBootCP properties are space separated members of bootcp/cp to be removed or added. eg \`...cp.add=/usr/java/rhino.jar /usr/java/scary.jar\` will add those two jars to cp. Eg: \`...bootcp.remove=rhino.jar tagsoup.jar\` will remove those two jars no meter of path. Removal is done first.) - deployment.log false (Possible: are true or false) - deployment.log.file false (Possible: are true or false) - deployment.log.file.clientapp true (Possible: are true or false) - deployment.log.file.legacylog false (Possible: are true or false) - deployment.log.headers false (Possible: are true or false) - deployment.log.stdstreams true (Possible: are true or false) - deployment.log.system true (Possible: are true or false) - deployment.manifest.attributes.check ALL (Possible: (Values that can be used alone only): \[ALL, NONE\] (Values that can be used in combination separated by the delimiter "," with no space expected ): \[ALAC, CODEBASE, ENTRYPOINT, PERMISSIONS, TRUSTED\]) - deployment.max.urls.download.indicator 16 (Possible: are in range 1 to 1,024 (inclusive)) - deployment.plugin.jvm.arguments null - deployment.proxy.auto.config.url null (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/)) - deployment.proxy.bypass.list null - deployment.proxy.bypass.local null - deployment.proxy.ftp.host null - deployment.proxy.ftp.port null - deployment.proxy.http.host null - deployment.proxy.http.port null - deployment.proxy.https.host null - deployment.proxy.https.port null - deployment.proxy.override.hosts null - deployment.proxy.same false (Possible: are true or false) - deployment.proxy.socks.host null - deployment.proxy.socks.port null - deployment.proxy.type 3 (Possible: are in range -1 to 3 (inclusive)) - deployment.security.askgrantdialog.notinca true (Possible: are true or false) - deployment.security.askgrantdialog.show true (Possible: are true or false) - deployment.security.expired.warning true (Possible: are true or false) - deployment.security.itw.ignorecertissues false (Possible: are true or false) - deployment.security.jsse.hostmismatch.warning true (Possible: are true or false) - deployment.security.level null (Possible: DENY\_ALL DENY\_UNSIGNED ASK\_UNSIGNED ALLOW\_UNSIGNED) - deployment.security.notinca.warning true (Possible: are true or false) - deployment.security.sandbox.awtwarningwindow true (Possible: are true or false) - deployment.security.sandbox.jnlp.enhanced true (Possible: are true or false) - deployment.security.trusted.policy null (Possible: include an absolute path to a file or directory) - deployment.small.size.override.height 600 (Possible: are in range -9,999 to 9,999 (inclusive)) - deployment.small.size.override.width 800 (Possible: are in range -9,999 to 9,999 (inclusive)) - deployment.small.size.treshold 10 (Possible: are in range 0 to 1,000 (inclusive)) - deployment.system.cachedir null (Possible: include an absolute path to a file or directory) - deployment.system.config null (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/)) - deployment.system.config.mandatory false (Possible: are true or false) - deployment.system.security.cacerts $JAVA\_HOME/lib/security/cacerts (Possible: include an absolute path to a file or directory) - deployment.system.security.jssecacerts $JAVA\_HOME/lib/security/jssecacerts (Possible: include an absolute path to a file or directory) - deployment.system.security.policy null (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/)) - deployment.system.security.trusted.certs $JAVA\_HOME/lib/security/trusted.certs (Possible: include an absolute path to a file or directory) - deployment.system.security.trusted.clientautcerts $JAVA\_HOME/lib/security/trusted.clientcerts (Possible: include an absolute path to a file or directory) - deployment.system.security.trusted.jssecerts $JAVA\_HOME/lib/security/trusted.jssecerts (Possible: include an absolute path to a file or directory) - deployment.user.cachedir $XDG\_CACHE\_HOME/icedtea-web/cache (Possible: include an absolute path to a file or directory) - deployment.user.locksdir $TMP/$USER/netx/locks (Possible: include an absolute path to a file or directory) - deployment.user.logdir $XDG\_CONFIG\_HOME/icedtea-web/log (Possible: include an absolute path to a file or directory) - deployment.user.pcachedir $XDG\_CACHE\_HOME/icedtea-web/pcache (Possible: include an absolute path to a file or directory) - deployment.user.runningfile $TMP/$USER/netx/locks/netx\_running (Possible: include an absolute path to a file or directory) - deployment.user.security.policy $XDG\_CONFIG\_HOME/icedtea-web/security/java.policy (Possible: include any valid url (eg. http://icedtea.classpath.org/hg/)) - deployment.user.security.trusted.cacerts $XDG\_CONFIG\_HOME/icedtea-web/security/trusted.cacerts (Possible: include an absolute path to a file or directory) - deployment.user.security.trusted.certs $XDG\_CONFIG\_HOME/icedtea-web/security/trusted.certs (Possible: include an absolute path to a file or directory) - deployment.user.security.trusted.clientauthcerts $XDG\_CONFIG\_HOME/icedtea-web/security/trusted.clientcerts (Possible: include an absolute path to a file or directory) - deployment.user.security.trusted.jssecacerts $XDG\_CONFIG\_HOME/icedtea-web/security/trusted.jssecacerts (Possible: include an absolute path to a file or directory) - deployment.user.security.trusted.jssecerts $XDG\_CONFIG\_HOME/icedtea-web/security/trusted.jssecerts (Possible: include an absolute path to a file or directory) - deployment.user.tmp $XDG\_CACHE\_HOME/icedtea-web/tmp (Possible: include an absolute path to a file or directory) ## FILES - $JAVA\_HOME/lib/deployment.config java-global deployment properties file. May be affected by deployment.jre.dir. - $XDG\_CACHE\_HOME/icedtea-web/cache Contains cached runtime entries. Controlled by **deployment.user.cachedir** - $XDG\_CACHE\_HOME/icedtea-web/cache/recently\_used 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/generated\_jnlps Location where jnlp files generated from html pages for javaws applications desktop/menu launchers icons are stored - $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\_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. 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\ http://icedtea.classpath.org/bugzilla\ 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 java console) with URL to jnlp or html file (or the jnlp/html file or application itself) when filing out the bug report.\ ## AUTHOR The following people have made contibutions to this project.\ Please keep this list in alphabetical order.\ Lillian Angel \Andrew Azores \Deepak Bhole \Laurent Bourgès \Adam Buchta \Ricardo Martín Camarero \Marcin Cieslak \Danesh Dadachanji \Adam Domurad \Lukasz Dracz \Thomas Fitzsimmons \Olesya Gerasimenko \Michał Górny \Mark Greenwood \Tereza Hlavackova \Lars Herschke \Peter Hatina \Andrew John Hughes \Jie Kang \Alex Kashchenko \Matthias Klose \Alexandr Kolouch \Jan Kmetko \Francis Kung \Denis Lila \DJ Lucas \Omair Majid \Jon A. Maxwell \Thomas Meyer \Kurt Miller \Saad Mohammad \Martin Olsson \Stefan Ring \Ville Skyttä \Fridrich Strba \Andrew Su \Joshua Sumali \Joel Tesdall \Michal Vala \Jiri Vanek \Tomáš Votava \Mark Wielaard \Jacob Wisor \Man Lung Wong \\ This project also includes code from the following projects:\ OpenJDK \\ Netx \\ ## SEE ALSO [**icedtea-web**(1)](/icedtea-web/1.md) [**javaws**(1)](/javaws/1.md) [**icedtea-web-plugin**(1)](/icedtea-web-plugin/1.md) [**itweb-settings**(1)](/itweb-settings/1.md) [**policyeditor**(1)](/policyeditor/1.md) **policytool**(1) **java**(1) http://icedtea.classpath.org/wiki/IcedTea-Web\ http://icedtea.classpath.org/hg/icedtea-web\