#LORIS Neuroimaging Platform Build Status

LORIS (Longitudinal Online Research and Imaging System) is a web-based data and project management software for neuroimaging research. LORIS makes it easy to manage large datasets including behavioural, clinical, neuroimaging and genetic data acquired over time or at different sites.

NEW ⇾ Try LORIS on Heroku before installing it on your system
Test out the project management and clinical data management side of LORIS (complete Imaging features not yet available)
Deploy and log in with username admin and the password that’s set up during deployment via ClearDB. Deploy

This Readme covers installation of the 17.0 LORIS development branch on Ubuntu. (CentOS Readme also available).

If you are looking to install a stable release, please consult the Releases page and the Readme for the last stable release.

Please consult the LORIS Wiki Setup Guide notes on this Install process for more information not included in this Readme. The LORIS Developers mailing list may also provide installation guidance not covered in the Wiki.

Prerequisites for Installation

  • LINUX (supported on Ubuntu 14.04 and CentOS 6.5)
  • Apache2 (libapache2-mod-php5)
  • MySQL 5.5 or lower (libmysqlclient15-dev mysql-client mysql-server)
  • PHP 5.6 (php5 php5-mysql php5-gd php5-sqlite)
  • php5-json (for Debian/Ubuntu distributions)
  • Package manager (for LINUX distributions)
  • Composer : should be run with –no-dev option

Important: * Only PHP 5.6 is supported for LORIS 16.1. We recommend installing/upgrading PHP using this (deprecated) PPA repository: ppa:ondrej/php5-5.6 * MySQL 5.7 is not supported for LORIS 16.1 and will cause errors when loading LORIS. MySQL 5.5 or lower (5.*) is recommmended.
* Composer should be run with –no-dev option unless you are an active LORIS developer.

Consult the LORIS Wiki page on this Install process for more information.


  1. Set up LINUX user lorisadmin and create LORIS base directory:

    sudo useradd -U -m -G sudo -s /bin/bash lorisadmin
    sudo passwd lorisadmin
    su - lorisadmin

    Important ⇾ All steps from this point forward must be executed by lorisadmin user

    sudo mkdir -m 775 -p /var/www/$projectname
    sudo chown lorisadmin.lorisadmin /var/www/$projectname

    $projectname ⇾ “loris” or one-word project name

  2. Get code: Download the latest release from the releases page and extract it to /var/www/$projectname

  3. Run installer script to install core code, libraries, and MySQL schema (see LORIS Setup Schematic). The script will prompt for information, including usernames and folders which it will create automatically.

    For more information, please read the Install Script wiki page.

    cd /var/www/$projectname/tools
  4. Apache configuration and restart LORIS requires Apache’s mod_rewrite module to rewrite its URLs. Enable this module, then restart Apache:

    sudo a2enmod rewrite
    sudo service apache2 reload
  5. Go to http://localhost to verify that the LORIS core database has been successfully installed. Congratulations! Log in with the username “admin” and the password you supplied for this user while running the Install script.

    Note: Apache config files will be installed as *.conf, per Ubuntu 14.04. If running an earlier version of Ubuntu, rename these files, then run the following commands. After, restart Apache.

    sudo a2dissite default
    sudo a2ensite $projectname
  6. Note that the default Loris setup assumes that Loris is running on localhost. If this is not the case, you’ll have to manually update the URL and Host config variables in the ConfigSettings table by running the following SQL commands from a MySQL prompt:

    UPDATE Config SET Value='$yourURL' WHERE ConfigID=(SELECT ID FROM ConfigSettings WHERE Name='url');
    UPDATE Config SET Value='$yourHostname' WHERE ConfigID=(SELECT ID FROM ConfigSettings WHERE Name='host');

    Make sure that $yourURL above contains the “http://” or “https://” and $yourHostname does not. If your server is only being accessed from localhost, you can skip this step.

  7. Follow the Setup Guide in the LORIS Wiki to complete your post-installation setup and configuration, and for more documentation.


Please feel free to subscribe to the LORIS Developers mailing list to ask any LORIS-related questions.

Related Repositories



Loris IIIF Image Server ...



LORIS is a web-accessible database solution for longitudinal multi-site studies. ...



Automatically run task on filesystem changes (unit testing, acceptance testing, etc) ...



The set of scripts that preprocess and insert MRI data into the database. ...



Loris docker image suitable for development environments ...

Top Contributors

driusan samirdas taracampbell Jkat rathisekaran jstirling91 stellarxo evanluc tedstrauss christinerogers cmadjar gluneau kongtiaowang alisterdev nirtiac nicolasbrossard olgatsib mpetkova ridz1208 mweiss17 karolinamara MounaSafiHarab johnsaigle xlecours KevinShustack davidblader jacobpenny mohadesz cyc115 brubo1


-   v17.0.0-rc1 zip tar
-   v16.1.3 zip tar
-   v16.1.2 zip tar
-   v16.1.1 zip tar
-   v16.1.0 zip tar
-   v16.1-rc1 zip tar
-   v16.0.2 zip tar
-   v16.0.1 zip tar
-   v16.0-rc2 zip tar
-   v16.0-rc1 zip tar
-   v15.10.2 zip tar
-   v15.10.1 zip tar
-   v15.10 zip tar
-   v15.10-rc5 zip tar
-   v15.10-rc4 zip tar
-   v15.10-rc3 zip tar
-   v15.10-rc2 zip tar
-   v15.10-rc1 zip tar
-   v15.4 zip tar
-   v15.4k zip tar
-   state_20080930 zip tar
-   loris-14.12.1 zip tar
-   loris-14.12 zip tar
-   loris-14.10 zip tar
-   PublicRelease2 zip tar
-   GitHubRelease-201312 zip tar
-   16.0.0 zip tar
-   16.0-rc3 zip tar