Skip to content

aces/Loris

This branch is 2227 commits behind main.

Folders and files

NameName
Last commit message
Last commit date
Feb 25, 2019
Jul 4, 2019
Dec 23, 2020
Sep 18, 2019
Jun 20, 2019
Nov 29, 2019
Dec 23, 2020
Oct 25, 2019
Aug 8, 2019
May 27, 2019
Jul 22, 2019
Nov 12, 2019
Dec 13, 2019
Aug 20, 2018
Oct 28, 2015
May 4, 2017
Jan 20, 2017
Jan 14, 2019
Oct 15, 2018
Jun 23, 2016
Apr 30, 2019
Apr 3, 2019
Apr 15, 2019
Jul 22, 2019
Dec 2, 2016
Oct 17, 2014
Aug 13, 2019
Nov 12, 2015
Oct 18, 2019
Nov 3, 2017
Oct 18, 2019
Nov 16, 2017
Nov 12, 2015
Apr 26, 2019
Apr 27, 2019
Jun 13, 2017
Jun 10, 2019
Jan 19, 2019
May 23, 2019

Repository files navigation

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, genetic and biospecimen data acquired over time or at different sites.

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

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

Heroku

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.

Deploy

Installation

System Requirements

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

These dependencies are subject to change so be sure to verify your version of MySQL and PHP when updating LORIS. Installing some dependencies may require sudo privileges.

Install Steps

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

  1. Set up LINUX user lorisadmin, with sudo privilege, 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 the 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
    ./install.sh
    
  4. Run the makefile (use make dev if you are setting up a development sandbox)

    cd /var/www/$projectname
    make
  5. Apache configuration

If your apache configuration was not completed by the Install script, run the following enable rewriting of LORIS, enable your $projectname site, and restart apache: (run by user who has root privileges)

    sudo a2enmod rewrite
    sudo a2dissite default
    sudo a2ensite $projectname
    sudo service apache2 reload
6. Go to http://localhost/installdb.php and follow the instructions to finalize LORIS installation, then restart apache.

7. Follow the [Setup Guide in the LORIS Wiki](https://github.com/aces/Loris/wiki/Setup) to complete your post-installation setup and configuration, and for more documentation.

## Community

### Get in touch
For questions and troubleshooting guidance beyond what is covered in our GitHub Wiki, please subscribe to the [LORIS Developers mailing list](http://www.bic.mni.mcgill.ca/mailman/listinfo/loris-dev) and email us there. 

### GitHub Issues
For bug reporting and new feature requests, please search and report via our GitHub Issues. 
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.

## Contributing

The [LORIS team](http://loris.ca) at the Montreal Neurological Institute (MNI) is very happy to get code contributions and features from the global LORIS community. 

### Contributing Code
If you would like to contribute to LORIS development, please consult our
[Contributing Guide](./CONTRIBUTING.md).

## Powered by MCIN

LORIS is made by staff developers at the McGill Centre for Integrative Neuroscience ([MCIN.ca](www.mcin.ca)), led by Alan Evans and Samir Das at the Montreal Neurological Institute. 

See [LORIS.ca](www.loris.ca) for our current team, the history of LORIS, and our **Technical Papers**.

The original (pre-GitHub) LORIS development team from 1999-2010 included: Dario Vins, Alex Zijdenbos, Jonathan Harlap, Matt Charlet, Andrew Corderey, Sebastian Muehlboeck, and Samir Das.