LaraPass Docs logo

Installation

Installing LaraPass on your provisioned server.


Downloading

Download all the files you get after purchasing Larapass from CodeCanyon (Envato).

{primary} Keep the License File (with License/Purchase Code) safely as you will need it to activate LaraPass.

Extract all the files into a safe location. Also extract the laravel_source zip_file into a folder (it contains all the main files we will be uploading to our server).


Uploading

Open connection to your server using Bitvise SSH Client or CyberDuck

Navigate to your website directory under webapps

Upload all the files & folders you got from the larapass_source zip_file into the server directory.

{warning} Becareful not to miss any file or interrupt when uploading to server.


Installing

LaraPass comes with a simple installer out of the box which helps you to easily install LaraPass on any server with just few clicks.

Step # 1 - Navigate to

 yourdomain.com/admin/install

(or if your domain name has not yet propagated, you can use your server ip address instead)

 server-ip-address/admin/install

{info} It is recommended that you wait for your domain name dns to propagate and use yourdomain.com/admin/install route for installing.

Step # 2 - If the Requirement Checks Pass, Click on Next to proceed.

Step # 3 - Enter your License/Purchase Code and your Envato/Codecanyon Username & Click on Verify

Step # 4 - Our license box will verify your LaraPass License and respond accordingly. If successful, you will get the success message and the option to Proceed, if license check failed, you will get an appropriate error and you can try again.

Step # 5 - Most Important Setting up your Environment File. If you are familiar with Laravel .env files, you can make any changes you like, however, if you are not, then only change the Fields shown below :

App Name : Enter Your App Name.
App Environment : Select Production (if you are running Live) or Local (if you are just testing on local machine).
App Key : A Unique Key will be generated for your app. Copy and store in a safe place. This key will be used for encrypting/decrypting data, if you lose or change this key later on, it may break the script.
App Debug : Set to True only if you are running in local environment for testing purpose. For Live servers, keep it False.
App URL : Your application URL Address.
Database Hostname : On most servers/machines localhost is the default hostname, if its different for your server then change it.
Database Port : Same as above, change only if you know your server uses a different port than the default one.
Database Name : Your Database Name
Database Username : Your Database Username (name of the user authorized to access your db).
Database Password : Password You set for the user. (leave it blank for 'null').
--------------------------------------------------------------------
Dont change any other options if you dont know how to configure them
--------------------------------------------------------------------
For the Mail Options, Check out our guide for setting up Mailgun in the Menu : Miscellaneous -> Mailgun
--------------------------------------------------------------------
Mail Driver : log or smtp ('log' for local environment, leave all other mail options as is since they wont matter, 'smtp' for send emails to users)
Mail Host : smtp.mailgun.org (if using Mailgun for Emails)
Mail Port : 587
Mail Username : postmaster@yourdomain.com (You will get this id from Mailgun).
Mail Password : xxxxxxxxxxx (You will get a password from Mailgun).
Mail Encryption : tls (default)
Mail From Address : [Use email address that users will receive all emails from].
Mail From Name : [Name that will shown to users when they receive email from you].
Mailgun Domain : Your Mailgun API Domain (You will get this from mailgun).
Mailgun Secret : Your secret key required to access your mailgun api (You will get this from Mailgun).

Click on Save Env File

Step # 6 - Once your environment file is saved, you will get the option to Migrate DB, click on it to complete the Database Setup process. If there are any errors, it will return an appropriate message, if not, then it will complete your LaraPass installation.

Step # 7 - Finally, it will give you a default username and password for the Admin Account. Go to https://yourdomain.com/login and use the admin credentials to login.

Default Admin User Details -
Username : admin
Password : larapass@admin

This completes your LaraPass Installation process. In the next step we will learn more about configuring your app using your custom logo,etc.


[LaraPass Installation Video]