Installing the Jmol Applet on a Server

Because Jmol functionality depends on a Java applet and Javascript, it is only easy to install pages containing Jmol on plain vanilla web servers (ie. Apache).  These instructions may not work for Microsoft servers (anybody with access to one who tests this let me know the results). If you are using a content management system (CMS) these instructions are likely to fail as most CMS installations don't allow random applets or javascript to function within them.  CMSs are also difficult to load a whole directory structure into.  Some of the Jmol team is working on embedding Jmol in wikis (see the Jmol wiki for more information). If you do not know how to add content to your web server you should discuss this with your web administrator before attempting to install Jmol or pages that use Jmol.

You will need to load a number of files onto your server.  The best way to accomplish this is to make an ftp or sftp connection to your web server.
Some possible software choices for file transfer are Filezilla for Windows, MacOS or LINUX, MacOS Finder for ftp, Fugu for sftp on MacOS, and the standard fileviewer in most LINUX distributions.

Upload the Jmol applet onto your server in the appropriate place, usually somewhere near the top of the directory structure you have access to.  You only need to do this once or if you upgrade your Jmol applet.  At a bare minimum you should install the following files in a directory dedicated to Jmol: Jmol.js, JmolApplet.jar, all JmolApplet0_...jar files, and LICENSE.txt.  You only need to install the signed applet .jar files if you wish your pages to use the applet to access files on computers other than your server.  Make sure you know where you are installing the Jmol directory as you will have to specify the path to Jmol in web pages you create.

Last Update: August 13, 2009
Expires: --
by J. Gutow