Install Script

christinerogers edited this page Jul 7, 2017 · 34 revisions


As of Loris 17.0.3 this page is archived.

Please see Installing LORIS wiki page for up-to-date installation steps.

If you're looking for LORIS 16.X instructions, click here.

  1. Notes on Operating systems and Dependencies
  2. Running the Install Script and Web-based Database Installer
  3. Troubleshooting

Notes on Operating systems and Dependencies


  • The install script should install Composer and dependencies including smarty3. There is no need to install these dependencies before running the install script.
  • Note that PHP 7 and MySQL 5.7 are recommended for LORIS 17.0 (Fall 2016)


  • There aren't exact 17.0 instructions for CentOS but most of the next section will work with CentOS. The information here may help with your install process until instructions are written.

Running the Install Script and Web-based Database Installer

The Install script and web-based database installer is designed to be run on Ubuntu (14+) or CentOS systems.

The new instructions may be found here


If re-running the Install script, remove (rename) the config.xml file stored in the project/ directory. If this file exists, the install script will abort.

For Ubuntu installations, if any difficulties are encountered in the install script, Composer can be manually installed thus: To manually install Composer

  curl -sS | php;
  sudo mv composer.phar /usr/local/bin/composer
  composer install

Running composer install may fail if you do not have a project/libraries directory created:

   cd /var/www/loris/
   mkdir -p project/libraries
   composer install # try again
NOTE: Smarty 3 is installed by Composer. For Ubuntu the recommended smarty3 package can be manually installed using: 
> apt-get install smarty3

Once your install script has finished running, if your Loris does not load:

  • Check your apache logs. e.g. Ubuntu: /var/log/apache2/$project-error.log and $project-access.log

  • If you see a PHP Fatal error about DateTime -- set your timezone in your php.ini file. The error usually looks like this:

PHP Fatal error: Uncaught exception 'Exception' with message 'DateTime::__construct() ...

NEXT: (2) Project Customization

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.