Installation Guide via Cpanel

Steps For Installing Software On Your Server

There are various steps for installing software

1. Login to the Server

   First you have to logged-in your server.

   
2. Manage Web Hosting

   After login, then click manage the web hosting.

   
3. Create Database

   After second step, then click database button for create database.

   
   1. Database Name

      Here enter the database name.

   2. Username

      Enter the username.

   3. Password

      Enter the strong password of that database.

   4. Create

      After entering the name of database, username and password then click create button. Your software's database successfully created.

4. Check PHP Configuration

   After creating the database set php configuration to PHP 8.2.

   
5. Upload software on server

   There are two methods for upload software on server.

   1. Using Git Repository

      Then go to git page. Here you will enter the git repository path of your software.

      
      1. Repository

         Here you enter the git repository path of your software.

      2. Branch

         Here you enter branch name that you will deploy on the server. Usually main or master branch will deploy on the server.

      3. Directory

         If you deploy directory to public_html then you will leave this blank. Otherwise, enter the directory name where you want to deploy software. Make sure that folder is empty.

      4. Create

         After entering the path of repository, branch and directory then click create button. After creating git repository click on the deploy button for deploy the software on server.

      
   2. Direct upload software zip file

      You can also direct upload your software's zip file on server. Then extract your zip file.

      

      After clicking this button you will see the option for uploading file or folder. Click on file button and select the zip file from your local storage. After uploading zip file then you should extract this zip file on serve. Then your software's file successfully upload on your server.

      
6. SSH Access

   After create git repository, then you have change ssh status inactive to active with the help of enable button.

   
   1. Add SSH Key

      After change status you have add ssh key of your local pc for login server into your local terminal.

   2. Login to SSH

      After that open your local terminal or cmd. Here enter the ssh code (ssh -p portnumber username@ip).

      
   3. Creating .env File
      1. Using Install.sh

         After login to your terminal, go to the public_html folder and run bash install.sh command.

         

         After run this command, Installer will check the composer installed or not on your server. If composer installed then it checks the PHP version is PHP 8.2 or not of your server. If PHP version PHP 8.2 then it will check the extensions enabled or not on your server. If all given extensions are enabled then it will give the permission to folders.

         1. Development Environment

            Set development environment to production or local.

            
            If development environment is local then WSL or Git Bash installed in your local device.
         2. Software Details
            1. Website Domain

               Enter here your website domain where you run this software.

            2. Website Name

               Enter the name of your website that you want to set the title of your website.

            3. Website Email

               Enter the official email of your website. The all emails of software will fire through this email.

               
         3. Database Details
            1. Database Host

               Set database host to localhost / 127.0.0.1.

            2. Database Username

               Enter here the username of your database that was created earlier.

            3. Database Port

               Enter here the port of your database. For ex: 3306.

            4. Database Password

               Enter here the correct password of your database that was set for your database.

            5. Database Name

               Enter here the name of your database that was set.

               

            After entering the all details, this installer build connection to your database. If database connection build successfully, then it will create the .env file to the root directory. After that it will install the all dependencies of your software. After installing dependencies it will update the composer, then migrate the database and seed the default data of your software. After seeding the data it will link the storage folder of your software.

      2. Manually

         You can create .env file by manually in your software's root directory. You should copy the .env.sample file from root directory and paste in the .env file. In this file you have to change some values.

         1. APP_NAME = title of your website
         2. APP_URL = full domain of your website
         3. DB_DATABASE = name of the database
         4. DB_USERNAME = database username

         5. DB_PASSWORD = password of your database user

         After these changes save .env file in your software's root directory.

7. Create .htaccess File

   After this step you need to create a .htaccess file to your server's file manager.

   

   Enter here name of the file (.htaccess).

   

   After creating a file enter this code into the file.
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteRule ^(.*)$ public/$1 [L]
</IfModule>

8. Cron Jobs

   After this step you need to create a new cron job from cron job page. Enter this command public_html/artisan schedule:run in command field. Then select every minute, every hour, every day, every month and every weekday options from minute, hour, day, month and weekday fields respectively. Then click on the save button.

   

After completing all the steps your software will successfully deploy on your server.