Sophie Net: Vamp HQ - Luxor XUL - Rachel - Apollo - The Saturn Times - The Richmond Post
vamphq.com Logo
All the tools to deliver rich, cross-plattform, zero-admin desktop apps built on open standards today
About
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
Projects
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
Download
BinariesGet It Now
DocumentationPDF Booklets, Presentations
Support
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 http://lopica.sourceforge.net/conf.html. Please click on the new address and update any bookmarks you might have.

Intro

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 comments@vamphq.com.

Here we go

javaws

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

Example

javaws.whenInstall=0
javaws.whatInstall=3

javaws.favorites

Key Value Description
size int Favorite counter

Example

javaws.favorites.size=0

javaws.favorites.size=2
javaws.favorites0=http\://www.jenomics.de/vamp/clare.jnlp
javaws.favorites1=http\://www.javazoom.net/jlgui/jws/jlgui.jnlp

javaws.player

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

Example

javaws.player.remoteURL=file\:///d\:/venus/jnlp/home.html
javaws.player.bounds=186,25,522,483
javaws.player.mode=1
javaws.player.manager=1

javaws.cfg

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)

Example

javaws.cfg.logToFile=true
javaws.cfg.logFileName=C\:\\WINDOWS\\.javaws\\javaws.log
javaws.cfg.showConsole=false
javaws.cfg.showSplashScreen=true

javaws.cfg.proxy

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

Example

javaws.cfg.proxy.setting=NONE

javaws.cfg.proxy.httpproxyoverride=localhost

javaws.cfg.cache

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

Example

javaws.cfg.cache.dir=C\:java\\jws\\v101\\.javaws\\cache

javaws.cfg.jre.[index]

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)

Example

javaws.cfg.jre.0.platform=1.4
javaws.cfg.jre.0.product=1.4.0
javaws.cfg.jre.0.location=http\://java.sun.com/products/autodl/j2se
javaws.cfg.jre.0.path=C\:\\java\\jdk\\v14\\jre\\bin\\javaw.exe

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