Sophie Net: Vamp HQ - Luxor XUL - Rachel - Apollo - The Saturn Times - The Richmond Post Logo
All the tools to deliver rich, cross-plattform, zero-admin desktop apps built on open standards today
OverviewFront Page
What's NewHistory As It Happens
Upcoming EventsWhere Do I Go Tommorrow?
ScreenshotsPictures, Pictures, Pictures
TestimonialsWhat Users Say About Vamp
CreditsThanks, Thanks, Thanks
ContactAre You Real? - Ich Spreche Deutsch
Site MapFind It Quick
Vamp StudioPackage, Sign and Publish Your App
Package ManagerCreate and Share Your Own CD App Collections
App CentralFind the Best Apps On The Web
JNLP ValidatorDTD, XML Schema, Relax
jnlp2htmlCreate Your Own App Catalog
Web Start Cache ExplorerUnder the Hood: Web Start's Cache Revealed
Web Start Cache UtilityInject Your App Into Web Start's Cache
Ant Task SuiteAutomate, Automate, Automate
vampgetGrab Apps for Offline Consumption
CD App InstallerCreate Your Own Single-Jar, Offline Installer
CD App Installer IICreate Your Onw Self-Executing, Single-Jar Installer
CD Installer MissionGreat Things Are Coming
BinariesGet It Now
DocumentationPDF Booklets, Presentations
DiscussionAsk Questions
FAQAnswer, Answers, Answers
Professional Services
InfoHire Me - Yes, I'm Available
Web Start
Web Start LinksEverything to Get Started
Unofficial FAQAnswers, Answers, Answers
JNLP Tag Quick ReferenceQuick Reference to Tags and Attributes
JNLP Tag ReferenceAll Tags Explained, Real-World Examples
Configuration ReferenceHand-tune Web Start's configuration (jawaws.cfg); all config settings explained
Offline Installer TutorialCreate Offline, No-Java, High-Speed Installer for Web Start under Windows
Installation ResourcesCreate Your Own Java Runtime Plus Web Start Installer
os and arch CollectionLinux, Windows, Mac, Solaris
Java 2 Runtime DirectoryLinux, Windows, Mac, Solaris
Web Start 2.0If I Were King
Print Version Print Version

Java Web Start Configuration (javaws.cfg) Reference

Note, this page has moved and now lives at Please click on the new address and update any bookmarks you might have.


You can configure Web Start in two ways:

  1. You can kick off the Web Start Jukebox (that is, the application manager) and click your way through a panel maze hunting down wizards with a limited bag of tricks.
  2. You can fire off a text editor and open up the plain-text Web Start configuration stored in javaws.cfg and fix up all your settings to your liking all-at-once in one place without calling on a legion of hard-to-find wizards.
Track down the Web Start config files

Web Start uses two javaws.cfg files.

The first confg file resides in Web Start's installation directory and holds the initial settings (mainly the location of Java runtimes available at installation time.)

The second config file resides in the user's "home" directory (whatever the system property user.home returns varies from Linux to Windows). This config file holds the user's configuration changes such as proxy settings, new or changed Java runtimes, logging, console and other settings.

Help to improve this reference; your comments are welcome

This Web Start Configuration Reference is a living, growing body of knowledge, not just a publish-and-forget-it static dead-tree document, help to improve it.

Your comments, suggestions, or corrections are welcome. Send them to

Here we go


Key Value Description
whenInstall 0 | 1 | 2 | 3 Turns on/off desktop integration (that is, desktop shortcut icons, startup menu entries, etc.); Possible values: 0 - Always; 1 - Ask on first startup; 2 - Ask on second startup; 3 - Never
whatInstall 0 | 1 | 2 | 3 Fine tunes desktop integration (that is, choose desktop shortcut icons, startup menu entries, etc.); Possible values: 0 - Nothing; 1 - Desktop shortcut icons only; 2 - Startup menu entries only; 3 - Both




Key Value Description
size int Favorite counter





Key Value Description
remoteURL URL URL to HTML page pointing to Web Start apps for display in the remote apps catalog (Web Start extracts all links with .jnlp extensions from the HTML page)
bounds rectangle Holds the Web Start Jukebox screen coordinates
mode 0 | 1 Toogle between offline and online; 0 - Offline; 1 - Online
manager 0 | 1 | 2 Speficies what apps to display; Possible values: 0 - Remote Apps; 1 - Downloaded Apps; 2 - Favorite Apps




Key Value Description
logToFile true | false Turn on/off logging
logFileName file path Name of log file
showConsole true | false Show/hide console window
showSplashScreen true | false Show/hide mini splash screen (popped-up before Java runtime starts up)




Key Value Description
setting NONE
httpproxyoverride hostnames non proxy host list; hosts with direct access not passing through proxy





Key Value Description
key directory path Directory path to Web Start cache root




Key Value Description
platform version vendor-neutral Java runtime version
product version vendor-specific Java runtime version
location URL Java runtime download location (points to an installer servlet; not to the Java runtime itself)
path command line Command line to start Java runtime (requires full directory path)



All the tools to deliver rich, cross-plattform, zero-admin desktop apps built on open standards today Logo
Send your comments, suggestions or praise to Copyright © 2001, 2002 Gerald Bauer