1) Extract files

Extract the zip file you downloaded from CodeCanyon in a directory where we will work from e.g. extract in /home/<user> to get /home/<user>/Insura-2.0(Recommended for users on shared hosting with cPanel). This location should be away from your webserver’s root directory.

2) Database setup

Insura supports a range of databases (MySQL, PostgreSQL, SQLite3 and SQL). Depending on your choice of database, create a new database and new user and password for it where applicable. Remember to note down the database nameand user and password where applicable as we will use this in step 4.

NB: If you are using SQLite, copy the sqlite file to /home/<user>/Insura-2.0/Files/database/ and note down the filename instead e.g. insura.sqlite.

3) Root directory

There are several ways to configure the root directory depending on your hosting setup.

• If you can control your domain’s document root, e.g when creating a sub-domain in your control panel, point it to /home/<user>/Insura-2.0/Files/public.
• If your root directory is in your home folder, e.g. /home/<user>/public_htmlwhere public_html is the root directory, follow these steps:-
  >> Back up your current root directory by renaming it i.e. public_html to public_html.backup.
  >> From our working directory created in STEP 1, copy the file called root_dir in Utils to your home folder.
  >> Rename root_dir to public_html
• If your root directory is not in your home folder (e.g. /var/www/html where htmlis the root directory) or you intend to add as a folder on he root directory (e.g. /var/www/html/insura where html is the root directory), follow these steps:-.
  >> Create a symbolic link to /home/<user>/Insura-2.0/Files/public
  >> Replace your document root with the link (To have something like http://www.example.com) or add it to your document root as a folder (To have something like http://www.example.com/insura) as preferred. Ensure you rename the copied link correctly for it to work.

4) Web setup

Insura ships with a web installer accessible through your browser. After confirming that steps 1 – 3 were successfully completed, please navigate your browser to your domain e.g http://www.example.com or https://www.example.com/insura. A setup page will appear which guides you through the rest of the setup. Use the information we noted down in steps 1-3 to complete the forms. Ensure you key in the correct passwords where applicable.

NB: Ensure the webserver has read and write access to the storage and bootstrap folders and everything in them which can be found in in the /home/<user>/Insura-2.0/Files directory. Also, if you have an SSL certificate for your domain, please use the https:// scheme to access the site e.g https://www.example.com to improve security.
To make https a must when using apache, uncomment (Remove the preceding ‘#‘ character) lines #9 and #10 in the .htaccess file found in your new root directory created in Step 3 above like shown below:
Change

to

5) First sign in

If all went well and the setup was completed, CONGRATULATIONS! You should now be able to log in and use Insura. You could even ignore the rest of the steps… Just kidding! Move on to step 6.

NB: If you encountered an error and re-tried steps 1 – 4 with no luck, skip to the manual installation section.

6) Cron jobs

Insura uses cron jobs to automate reminders. You need to set a cron job that will do this on your server. Below is the sample cron job code. Modify the path to artisan to match your working folder, for our example this would be /home//Insura-2.0/Files/artisan. When this is done, Insura is fully ready to use, but if you want more, there’s more.

Here is a great YouTube Video to help you with cron jobs if you are new.

7) Supercharge Insura

Insura uses laravel queues to send emails and texts in the background, therefore making your app faster. By basic installation the queue driver is set to sync which is slow, but if you want even more speed and true background execution, the database driver can be used. All you need is to change the queue driver and shell access to run a queue listener using these steps:-

• >> In our working folder created in Step 01 (/home/<user>/Insura-2.0), navigate into Files. In there is a file named .env. If you cannot see it, ensure you have enabled viewing of hidden files in your file manager settings. This file stores all major settings of insura. Open this file and edit the line with
  QUEUE_DRIVER=sync
  to mathch the following:

Close and save the file

>> Then execute the following command in the Files directory to start the listener:
php artisan queue:work --daemon --queue default,emails,texts --tries 10 database >> /dev/null 2>&1 &
Here is an example of how that may go…

That’s pretty much it by now. Feel free to rate us on CodeCanyon as you enjoy the awesome powers of Insura. To add a language to or translate Insura, see Translating Insura. To update your installation of Insura, see Update Insura.