Page tree
Skip to end of metadata
Go to start of metadata

XNAT is built to run within a Tomcat webserver and uses a PostgreSQL database to store data. To install XNAT, you will need to first install its prerequisites (Java, PostgreSQL, and Tomcat). After successfully installing the prerequisites, you can download the XNAT site builder  which will build an XNAT web application and deploy it to Tomcat. If you are experienced with XNAT, you can also download developmental versions of XNAT using the Build XNAT from Source Repository instructions. 

These applications should be installed and tested prior to installing XNAT:

  • Java JDK v1.7:  ( Download)
    • Unix Users: The Oracle JDK is recommended.  We've seen issues with the applets when using OpenJDK and the IcedTea plugin.
    • Function: Runs core XNAT engine.
    • Make sure to install the JDK and not the JRE.

      Oracle very much wants you to download Java 8. Java 8 is acceptable for clients, i.e. if you're running XNAT applets in your browser. XNAT does not work with Java 8! Make sure you download the latest version of the Java 7 JDK. We are working on migrating XNAT to work with Java 8, but there's no timetable for delivery.

  • PostgreSQL v9.1 or later (9.4 is preferred) (Download (Installation Guide)
    • Function: Database backend 
    • XNAT 1.7 supports v9.1+, but you should use the latest available version.
  • Apache Tomcat v7  (Download) (Installation Guide)
    • Function: Web application server
    • Be sure to read the section on Tomcat Configuration in the XNAT 1.7 Installation Instructions.

      XNAT 1.7 is not compatible with Apache Tomcat 8. Please make sure that you download the latest version of Tomcat 7, but there are a number of known issues with XNAT running on Tomcat 8.