#LORIS Neuroimaging Platform

LORIS is a web-accessible database solution for Neuroimaging. LORIS provides a secure online database infrastructure to automate the flow of clinical data for complex multi-site neuroimaging studies.

• LINUX (Optimized for Ubuntu 14.04) or Mac OS X (tested for 10.9)
• Apache2 (libapache2-mod-php5)
• MySQL (libmysqlclient15-dev mysql-client mysql-server)
• PHP/PEAR >= 5.2 (php5 php-pear php5-dev php5-mysql)
• php5-json (Debian/Ubuntu distributions)
• Git
• Perl
• Smarty 3
• Package manager

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. Setup public keys:

• On LORIS server, run ssh-keygen. Press Enter until key created.
• Copy key in ~/.ssh/id_rsa.pub and paste to GitHub⇾Account Settings⇾SSH Keys⇾Add SSH key.
• Enter Github password.

3. Get code:

• Click “Fork” in https://github.com/aces/Loris-Trunk. Fork to your Git-user.
• Clone fork to your server:

cd /var/www/
git clone [email protected]:your-git-username/Loris-Trunk.git $projectname

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

cd /var/www/$projectname/tools
./install.sh
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. Rename these if running earlier version.

sudo a2dissite default
sudo a2ensite $projectname

6. Notes for Loris post-installation setup are contained in the Loris Developers Guide.

Please feel free to subscribe to the LORIS Developer's mailing list, where you can feel free to ask any LORIS-related questions.

LORIS Developers mailing list

To upgrade LORIS to the latest version, pull the latest code from GitHub. MySQL patches are contained in the SQL/ subdirectory of LORIS. You must run any new patches that appear in that directory after running the git pull command. If you do not do this, some features may break as the MySQL table schema is likely out of date.