Installing the software

All current open-source versions of Saxon can be downloaded from the Saxonica Saxon-HE GitHub repository. It is also possible to install using Maven using the artifact id Saxon-HE (please avoid other artefacts using the Saxon name which were created at various times by third parties and are not maintained by Saxonica).

For the commercial versions of SaxonJ, please follow the download links from www.saxonica.com. Historic versions of the software are not listed on the website, but are available to existing users on request.

Installation of SaxonJ on the Java platform simply involves unzipping the supplied download file into a suitable directory. The procedure is the same for all editions (HE, PE, and EE). The JAR files are differently named in each edition.

One of the files that will be created in this directory is the principal JAR file. This is saxon-he-12.0.jar, saxon-pe-12.0.jar, or saxon-ee-12.0.jar depending on which Saxon edition you are using. The "12.0" in the name will change to "12.1", "12.2", etc. in subsequent maintenance releases.

There are some additional JAR files to support optional features such as the SQL interface and the ICU localization library (see JAR files included in the product for details). When running SaxonJ, the principal JAR file should be on the class path. The class path is normally represented by an environment variable named CLASSPATH: see your Java documentation for details. Note that the JAR file itself (not the directory that contains it) should be named on the class path.

Some environments (for example Java IDEs such as Eclipse, and servlet containers such as tomcat) build the classpath themselves: they might ask you to register the location of JAR files via a graphical user interface or a text configuration file, or they might ask you to put the JAR files in a well known place (for example WEB-INF/lib in the case of tomcat). Follow the instructions for the environment you are using.