Installation


Server requirements

Apache 2.4

  • mod_rewrite

PHP 7.4 to 8.0

Check that your PHP version and configuration is valid both for PHP Web & CLI.

  • BCMath
  • Ctype
  • Fileinfo
  • JSON
  • Mbstring
  • OpenSSL
  • PDO (PDO_MYSQL / PDO_PGSQL)
  • Tokenizer
  • XML

Database

  • MySQL: 5.7 or 8.0
  • MariaDB: 10.3 or 10.4
  • PostgreSQL: 12

Utilities

  • Git
  • Composer 2

Installation

First steps

Assuming that you want to install TRAX LRS in a folder named traxlrs:

git clone --recursive --branch beta2 https://github.com/trax-project/trax2-extended-lrs traxlrs
cd traxlrs
composer install

File permissions

Folders storage and bootstrap/cache require write access by the web server. If you are not sure how to configure this, you can use the following commands for testing purpose.

chmod -R 777 bootstrap/cache
chmod -R 777 storage

Web server

For security reasons, only the public folder should be accessible by the web server. Create a virtual host and configure the document root to traxlrs/public.

Database

Create an empty database with the utf8mb4_unicode_ci encoding. Then, at the root of the application folder, make a copy of the .env.example file, rename it .env and enter your database settings.

MySQL/MariaDB example:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=traxlrs
DB_USERNAME=root
DB_PASSWORD=

PostgreSQL example:

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=traxlrs
DB_USERNAME=postgres
DB_PASSWORD=aaaaaa

Last Steps

php artisan key:generate
php artisan migrate

Admin account

You can now create an admin account with the following command. This will give your credentials to log into the application.

php artisan admin:create

Production server

In the .env file, change settings from:

APP_ENV=local
APP_DEBUG=true

To:

APP_ENV=production
APP_DEBUG=false

Then, check the instructions related to performances optimization.

Updates

If you already installed TRAX LRS Starter Edition, you can get the last minor updates with the following commands:

git pull origin beta2
git submodule update
composer dumpautoload