LORIS is a web-accessible database solution for longitudinal multi-site studies.
Switch branches/tags
Clone or download
Pull request Compare This branch is 1 commit ahead, 83 commits behind aces:17.0-dev.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
SQL
docs
htdocs
jsx
modules
php
smarty
test
tools
.babelrc
.dockerignore
.eslintignore
.eslintrc.json
.gitignore
.mailmap
.travis.yml
CONTRIBUTING.md
Dockerfile
Dockerfile.MySQL
Gruntfile.js
LICENSE
LORIS_react.README.md
PULL_REQUEST_TEMPLATE.md
Procfile
README.CentOS6.md
README.Mac.md
README.md
VERSION
Vagrantfile
app.json
composer.json
composer.lock
package.json

README.md

#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](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy?template=https://github.com/aces/Loris/tree/17.0-dev)

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

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+ and CentOS 6.5)
  • Apache2
  • MySQL 5.7
  • PHP 7
  • Package manager (for LINUX distributions)
  • Composer : should be run with --no-dev option

Important:

  • If you are upgrading your LORIS, you'll also want to upgrade to both PHP 7 and MySQL 5.7, since these dependency versions were not supported in the last release.
  • 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.

Installation

  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 Install Script wiki page.

    cd /var/www/$projectname/tools
    ./install.sh
    
  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.

Community

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