XNAT Jupyter Integration Home

Oct 30, 2023: Version 1.0.1 of the XNAT JupyterHub Integration plugin has been released!

The XNAT / JupyterHub integration allows users to launch Jupyter Notebooks with mounted XNAT project data, creating a prebuilt data exploration playground. Notebooks run in Docker Swarm containers, providing a scalable and isolated environment for running code against XNAT data. Additionally, notebooks can be saved to your XNAT and reopened for future work. This documentation will guide you through the setup, usage, and key features of the XNAT / JupyterHub integration.

Before installing, please consult the XNAT JupyterHub Version Compatibility Matrix to be sure this plugin will work on your system

Getting Started

• Getting Started with XNAT and JupyterHub

• JupyterHub XNAT Plugin Settings

Administering 

• Technical Overview

• Deployment

• Plugin Settings

• Jupyter Server Setup

• Picking or building a Docker image

  • MATLAB Integration

• User Authorization

• Monitoring User Activity

• Upgrading From Beta

Using JupyterHub with XNAT

This is a guide for XNAT users interested in launching Jupyter notebook servers directly from within XNAT. Tailored for users with a fully operational XNAT setup with both JupyterHub and its plugin, this documentation assumes a working knowledge of XNAT and familiarity with basic Jupyter functionality.

• Starting Jupyter from XNAT

• Using Jupyter Notebooks with XNAT Data 

Sample Notebooks

• Check out a few sample notebooks on GitHub