Skip to content

Latest commit

 

History

History
60 lines (46 loc) · 2.03 KB

install.md

File metadata and controls

60 lines (46 loc) · 2.03 KB

Installation of TERESAH

Requirements

  • PHP 5.5+
  • Composer
  • MySQL / Postgres / SQL Server
  • Apache (other webservers can be used)

Clone repository

In the install folder for TERESAH run git clone https://github.com/DARIAH-ERIC/TERESAH

Create a database for TERESAH

Create a empty database for TERESAH in MySQL / Postgres / SQL Server.

Copy and edit the configuration file

Make a copy of the configuration template .env.environment.php.template. For a production server the name shoud be .env.production.php Fill in the values for your database connection, configuration if oauth is used, encryption key for user passwords etc.

Install composer

Install composer on your server https://getcomposer.org/download/

Install depencencies via composer

TERESAH requires some third party libraries, all of these can be installed via composer. To install run: composer install

Initiate the database

To create the database structure run php artisan migrate. The tables will be created.

To fill the database with content from app/database/seeds/data/data.csv run: php artisan db:seed

Configure Apache

The webserver should be configured to use TERESAH/public as the webb root folder.

Example of configuration:

<VirtualHost teresah.myhost.org:80>
    ServerAdmin [email protected]
    DocumentRoot "/home/TERESAH/public/"
	
	<Directory "/home/TERESAH/public/">
	   Order allow,deny
	   Allow from all
	   AllowOverride All
	</Directory>
	
    ServerName teresah.myhost.org
    ErrorLog "logs/teresah.myhost.org-error.log"
    CustomLog "logs/teresah.myhost.org-access.log" common
</VirtualHost>

Install the harvester

If you wish to use the harvester, it needs an extra step for installation, please see the harvester page for more information.

Install on OSX 10.11+

To install on OSX, you will need to install php56 and mcrypt via homebrew, see this very good link. And also install "brew install php56-mcrypt".