The XNAT Desktop Client is available for use on modern Mac, Windows and Linux operating systems, though the installation methods and requirements differ for each system. 

Mac OS Installations

As of Beta 1.0.36, the latest supported Mac OS is 10.13.6 (High Sierra). Mac OS 10.14 (Mojave) is not yet supported.

The XNAT Desktop Client for Mac OS includes an embedded Java Runtime Environment. There have been known issues accessing this bundled resource in virtualized Mac environments, so we strongly recommend only installing the client on a native Mac OS.

Installation is very straightforward. 

  1. Download the .DMG file from download.xnat.org/desktop-client
  2. Open the .DMG file and drag the app into your Applications folder
  3. Open the application for the first time
  4. If you are prompted whether you want to run this application that was downloaded from the internet, say yes. (This may require you to enter your system password.) 

Opening the application for the first time will install file-handling support for all your browsers so that image session download requests from the XNAT web app will open in your desktop client. 


Windows Installations

The XNAT Desktop Client for Windows includes an embedded Java Runtime Environment. There have been known issues accessing this bundled resource in virtualized Windows environments, so we strongly recommend only installing the client on a native Windows OS. 

Installation is very straightforward. 

  1. Download the .exe file from download.xnat.org/desktop-client
  2. Open the .exe file , which launches the one-step installer

Installing the application will install file-handling support for all your browsers so that image session download requests from the XNAT web app will open in your desktop client. 


Linux Installations

Linux users must have a compatible JRE installed in order to use the XNAT Desktop Client.

The XNAT Desktop Client for Linux is distributed as an AppImage, which is an executable application that does not need a separate installation step. For more on working with AppImage files, see: https://docs.appimage.org/user-guide/faq.html#question-how-do-i-run-an-appimage 

  1. Download the .AppImage file from download.xnat.org/desktop-client
  2. Make the .AppImage file executable
  3. Run the .AppImage file

Running the application for the first time will install file-handling support for all your browsers so that image session download requests from the XNAT web app will open in your desktop client.