Skip to content
LORIS is a web-accessible database solution for longitudinal multi-site studies.
Branch: minor
Clone or download
kchatpar and driusan Fixed array convention from [] to array() (#4439)
Changed [] to array() for consistency across codebase.
Latest commit b46ea19 Apr 30, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github [Docs] Move GitHub templates to .github folder (#4001) Oct 15, 2018
.phan [phan/dashboard/media] Fix function redeclaration errors (#3893) Aug 22, 2018
SQL Merge tag 'v20.3.0' into PUSH_v20.3.0_INTO_MINOR Apr 26, 2019
docs Update API summary header and qc to include more info (#4077) Feb 4, 2019
htdocs Loris 20.3.0 Version + patches + JS transpiling + composer (#4443) Apr 11, 2019
jsx [JSX] Refactor SearchableDropdown to not use document.querySelector (#… Feb 25, 2019
modules Fixed array convention from [] to array() (#4439) Apr 30, 2019
php Loris 20.3.0 Version + patches + JS transpiling + composer (#4443) Apr 11, 2019
smarty/templates Publication Module (#3695) Mar 15, 2019
src [API] Adding json responses classes (#4275) Feb 20, 2019
test [Database] modify the _implodeWithKeys() function to allow IS NULL in… Jan 28, 2019
tools Updated Ubuntu version number to include later versions Apr 29, 2019
.babelrc [Core] Update Babel + Grunt (#2273) Oct 12, 2016
.dockerignore Clean up docker image Oct 28, 2015
.editorconfig [Core] Code style file (#2735) May 4, 2017
.eslintignore [Instrument builder] ESLint + fix errors caused by new react (#2486) Jan 20, 2017
.eslintrc.json Add ReactDOM to the list of globals (#2706) Mar 30, 2017
.gitignore [tools] 20.0 tools and SQL moved to proper directory (#3855) Aug 3, 2018
.mailmap ENH: initiate mailmap for a proper output in e.g. "git shortlog -sn" (#… Jun 23, 2016
.travis.yml Remove distro from Travis config (#4477) Apr 26, 2019 [Documentation] Fixed the link to in Contributing.… Mar 6, 2019
Dockerfile Fix minor branch Travis (#3495) Feb 19, 2018
Dockerfile.MySQL Updating Docker MySQL version (#3978) Oct 4, 2018
Dockerfile.test.db [Automation Test] test with RaisinBread data (#3139) Oct 25, 2017
Dockerfile.test.php7 Fix minor branch Travis (#3495) Feb 19, 2018
Dockerfile.test.php7.debug [Testing] Dockerized test suite (#2430) Dec 2, 2016
LICENSE This updates the license on all Loris header files Oct 17, 2014 [Documentation] React readme (#2884) Jun 16, 2017
Procfile Adding Procfile for heroku Nov 12, 2015 fixed spelling (#3865) Aug 7, 2018 [Installation] Updating Mac README with markdown updates (#3173) Nov 3, 2017 [Readme] Reformatting, add "Contributing" and "Help" sections (#4082) Jan 7, 2019
VERSION Loris 20.3.0 Version + patches + JS transpiling + composer (#4443) Apr 11, 2019
Vagrantfile [Install/Vagrant] Add zip + unzip to vagrant install so that composer… Nov 16, 2017
app.json Adding app.json for heroku Nov 12, 2015
composer.json Loris 20.3.0 Version + patches + JS transpiling + composer (#4443) Apr 11, 2019
composer.lock Loris 20.3.0 Version + patches + JS transpiling + composer (#4443) Apr 11, 2019
docker-compose.yml Unbreak Docker tests (#2827) Jun 13, 2017
package.json [Core] Add babel-core as a dependency on minor branch (#4170) Dec 10, 2018
webpack.config.js Publication Module (#3695) Mar 15, 2019

Build Status LORIS Neuroimaging Platform

LORIS (Longitudinal Online Research and Imaging System) is a self-hosted web application that provides data- and project-management 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.

A demo instance is available at

This Readme covers installation of the LORIS v20.* release on Ubuntu. (CentOS Readme also available).

Please consult the LORIS Wiki Setup Guide notes on this Install process for more information.


You can try LORIS on Heroku before installing it on your system. The project management and clinical data management functions of LORIS are available for experimenting with. Imaging functionality is not yet available.

Deploy and log in with username admin and the password that's set up during deployment via ClearDB.



System Requirements

  • Apache 2.4 or higher
  • MySQL >= 5.7 (or MariaDB >= 10.3)
  • PHP 7.2 or higher
  • Composer

Composer should be run with --no-dev option unless you are an active LORIS developer.

These dependencies are subject to change so be sure to verify your version of MySQL and PHP when updating LORIS.

Install Steps

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, and libraries. The script will prompt for information and so that it can create directories automatically.

    For more information, please read the Installing Loris 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/installdb.php and follow the instructions to finalize LORIS installation.

    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. Follow the Setup Guide in the LORIS Wiki to complete your post-installation setup and configuration, and for more documentation.


GitHub Issues

Please don't hesitate to create an issue if you're stuck with something. Please include details such as the version of LORIS you're using as well as information such as the OS you're using, your PHP and Apache versions, etc.

Get in touch

Please feel free to subscribe to the LORIS Developers mailing list to ask any LORIS-related questions. We may also be able to provide you with installation guidance not covered in the Wiki.


Contributing Code

If you would like to contribue to LORIS development, please consult our Contributing Guide.

You can’t perform that action at this time.