GrassBlade LRS Installation

Please check and confirm that the server meets the system requirements at:

System Requirements 

NOTE: Important things to be careful of in case you get blank screen, or any errors during installation.






Some of the screenshots are for an older version of GrassBlade LRS, but the difference is only cosmetic.  

Step 1

The instructions assume that you are using cPanel to upload files and manage database. However, you can use any other tool that you might be using currently like: FTP, SSH, File Manager, phpMyAdmin or any other software that helps you upload files to your server, and manage your database. 

Login to your cPanel account. And open the File Manager. If you are not using cPanel, use your favourite method to upload the files to your server.


Step 2

Go to the document/http root. The folder can be named public_html, htdocs, /var/www or anything else depending on your server and configuration.



Step 3

Create a folder named grassblade-lrs
If you use any other name for folder, you will need to make several file changes. Please check here



Step 4

Go inside the grassblade-lrs folder and click on Upload to start the upload process.


Step 5

Click on Choose File and select the zipped file to upload. If your server allows to unzip on the server, or if you are using FTP, you need to Unzip the file on your desktop, and upload all the files.


Step 6

Wait till the file is uploaded and then go back to your File Manager.


Step 7

Click on Reload if the file doesn’t show yet.


Step 8

Click on the file name, and click on Extract to unzip the file.


Step 9

Make sure the folder is correct and click on Extract File(s).

Close the window after extraction is complete.

Press reload to see extracted files.



Step 10: Database Configuration

If you face any issues, please check this article.

In your browser, go to: you will be redirected to 

Enter your database details and click submit. Its preferred that you use the same database login details and prefix if you are planning to use the LRS with WordPress and GrassbBlade xAPI Companion plugin for Articulate. (see reference)

Using same database currently has only one advantage: If you are using Articulate, you can use the feature to import Translation which helps you see content name, slide name, questions and answers instead of odd url ids that Articulate sends. 

If you do not have a database, create a MySQL database by following these steps

1- Go to MySQL Data base wizard in your cpanel

2- Enter a name for your database

3- Create a username and password for database.

Choose all permissions in next step.

4- MySQL Database is created

Enter the details of your existing database or newly created MySQL database.

Click on Submit. (Please ignore if you see a bunch of error messages once) 


Step 11

Your database configuration file will be created automatically if php has write permission, or you will get a piece of code. Copy it and create a file with the content as instructed.


Step 12

You will see that several database tables are created. If you see a bunch of messages and errors, refresh the page and see if it disappears.

Installation is done, click on Login to continue logging in with default admin login:

Password: admin



Step 13: Creating a Manager

Change the admin credentials by going to Managers > All Managers and clicking on Edit.

Create a new manager by going to Managers > Add New. Enter the details and select the Role “user”. Click Submit to save.

PS: Please note that "Manager" was earlier named as "User" and hence you might find both words used inter-changeably at some places. 


Step 14: License Settings

You will see the License settings page, configure the license email and key from the email you have received.

If you see an error, please make sure:
i. You are using the license key for GrassBlade LRS and not GrassBlade xAPI Companion
ii. cURL is installed and enabled for PHP.
iii. If, you are using the LRS on localhost, or on additional test site, please check this article


Step 15: Generating Basic AuthToken

On the Manager Edit page for this new manager. Click on “Add New Basic Auth

Step 16: Auth details for your xAPI Program

Copy the API User, API Password, and Endpoint URL and use it in your xAPI Program, LMS or Content. If you are using GrassBlade xAPI Companion for WordPress, you need to configure it in your GrassBlade Settings page on WordPress.


NOTE: Important things to be careful of in case you get blank screen, or any errors during installation.






Home | GrassBlade xAPI Companion | GrassBlade LRS

Have more questions? Submit a request


  • 0
    Kevin Walsh

    Step 12 failed for me with no error message. The page just refreshes and I do not get logged in with the default login credentials.

  • 0
    Pankaj Agrawal

    This happens if you use a host like WPEngine which uses caching. You will need to ask them to disable caching on grassblade-lrs folder. 


  • 0
    Kevin Walsh

    My server admin had turned off PHP session cookies because it interfered with Varnish's ability to serve pages. It works now but with Varnish disabled. I will try another caching method like W3 Total Cache plugin.

  • 0

    I would suggest to document all of the required indexes that need to be applied to the tables in the DB.  The lack of these indexes becomes a problem when there are lots of statements. 

  • 0
    balayn stephane

    can anyone explain me what we have to put in

    configure --> integrations --> wordpress xAPI 

    i have put the adress of my wordpress site , the admin user of my wordpress site and its password but it says i have an error .

    Thank you for help



Please sign in to leave a comment.
Powered by Zendesk