TRAX LRS is an xAPI conformant Learning Record Store (LRS) built with Laravel.
It focuses on the core features of an LRS, and that's it!
We want to keep it simple and clean, and give you the freedom to build what you want around it.
Fore further information, visit http://traxlrs.com
TRAX LRS Starter Edition is distributed under the GNU-GPL3 license.
Copyright 2021 Sébastien Fraysse, http://fraysse.eu, [email protected].
- mod_rewrite
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
- MySQL: 5.7 or 8.0
- MariaDB: 10.3 or 10.4
- PostgreSQL: 12
- Git
- Composer 1.x
Assuming that you want to install TRAX LRS in a folder named traxlrs:
git clone --recursive --branch beta1 https://github.com/trax-project/trax2-starter-lrs traxlrs
cd traxlrs
composer install
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
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
.
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
In the .env
file, you can set the current environment, as well as a debugging option.
For testing and development:
APP_ENV=local
APP_DEBUG=true
For production:
APP_ENV=production
APP_DEBUG=false
php artisan key:generate
php artisan migrate
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
If you already installed TRAX LRS Starter Edition, you can get the last minor updates with the following commands:
git pull origin beta1
git submodule update
composer dumpautoload