Run As a Standalone Web Server

The easiest way to run JODConverter as a web application is to download the jodconverter-tomcat-x.y.z.zip distribution that includes the Apache Tomcat 5.5 web application server. This requires Java 5.0 to be already installed on your system.

Just unpack the zip package and then run the startup script in the bin folder that will start Tomcat on port 8080. JODConverter will be available at the following URL: http://localhost:8080/converter/. This provides a simple interface to upload a document, select the desired output format and perform the conversion. The web service interface (see next page) will also be available.

Deploy Into Your Own Servlet Container or Application Server

If you already have a servlet container/application server you can download the jodconverter-webapp-x.y.z.zip distribution that contains a war archive ready for deployment.

For example with Tomcat 4.1 or 5.5 all you have to do is

  1. optionally rename jodconverter-webapp-x.y.z.war to something more user-friendly since the name will be visible in the URL, e.g. converter.war
  2. copy it into the webapps folder inside the Tomcat installation
  3. it will be automatically deployed and visible at (tipically) http://localhost:8080/converter/
  4. if required, configure your firewall or servlet container to restrict access to the webapp