Getting Started
Prerequisites for installing XNAT
Download XNAT
Step by Step Guide to Installing XNAT

Installing DicomServer

Custom Installation Options

Build From Source

Download XNAT in a Virtual Machine

[Edit Nav]

Warning: These instructions cover the development version of XNAT and should be used accordingly. Changes are made daily. If you need a reliable XNAT installation, use the released versions available from xnat.org.


The installation instructions for XNAT from source are virtually the same as the standard installation guide. The only difference is that you should check the source code out of the source control repository rather then downloading it via zip or tar.gz.


Please review the XNAT license before installing the software. Your right to use this software is contingent on your acceptance of the license. Download and installation of software implies acceptance of this license.

Get Source Code

The stable development version of XNAT is located in the xdat_release repository. There clones for the major releases bugfixes (e.g. xdat_release_1_4 ) with tags for specific releases, (e.g. 1.4.1 ). The released version is essentially just a zipped version of the tag (with a few files added).

We will now cover cloning two repositories (xdat_release and pipeline) and downloading a file (build.properties). Once complete, you can proceed to the standard XNAT Installation Guide to complete the installation.

We will use command line instructions in your desired installation directory:

1. Clone xdat_release

Use Mercurial to get the source repository.
hg clone http://hg.xnat.org/xdat_release xnat

If you are interested in checking out a specific tag (e.g. the 1.4.0 release), use the -u option on the clone command:
hg clone -u 1.4.1 http://hg.xnat.org/xdat_release_1_4 xnat

2. Clone the XNAT pipeline manager

XNAT requires the pipeline project to be cloned into a subdirectory of xnat called "pipeline"
cd xnat
hg clone http://hg.xnat.org/pipeline

3. Create the build.properties file

For XNAT 1.4, you need to download the build.properties file into the root xnat directory:
wget ftp://ftp.nrg.wustl.edu/pub/xnat/build.properties
Windows users can download the build properties file here and save the file into the xnat folder.


From here you can follow the standard XNAT Installation Guide, skipping step 1, of course.