# Installation - Local Host

Follow the below steps carefully to install the QwikTest script in the localhost. Your computer must have PHP 7.4, MySQL 5.7.24 or higher, and Apache.

1. Configure environment
2. Create a database
3. Upload script downloaded from CodeCanyon to the XAMPP root folder.
4. Installation

#### Our Demo is powered by Digital Ocean VPS.

[![DigitalOcean Referral Badge](https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%201.svg)](https://www.digitalocean.com/?refcode=899d01009f04\&utm_campaign=Referral_Invite\&utm_medium=Referral_Program\&utm_source=badge)

See the below video for the installation process.

{% embed url="https://youtu.be/dlzrob2VKjw" %}

### Installation Process

#### Step 1

Download & Install **XAMPP**, preferably version 7.4.21 / PHP 7.4.21, in your local system using the following link. [https://www.apachefriends.org/download.html](https://www.apachefriends.org/download.html)

{% hint style="warning" %}
Instead of XAMPP, you can use WAMP, Laragon, Laravel Sail, or any other LAMP stack. The script just works. All you need to have is PHP >= 7.4.10 and MySQL >= 5.7.24 installed and configured properly. In this example, we are using XAMPP.
{% endhint %}

Now open the XAMPP Control Panel and then Start **Apache** and **MySQL**.

#### Step 2

Open phpMyAdmin and create a new database.

![](https://3791649983-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mb1ofvkThROm6pwq71N%2F-MfHc1qK3uHdpm4_j1iM%2F-MfHcB8mLZwKMBc9-drv%2Fphpmyadmin-create.PNG?alt=media\&token=0b6c9e45-ca22-462c-b7ab-4ff14d2196fd)

#### Step 3

Now copy the script upload\_this.zip file downloaded from CodeCanyon into the server root folder.

E.g. `C:\xampp\htdocs`

Extract the **upload\_this.zip** file in the same folder.

{% hint style="info" %}
QwikTest **CAN** only be installed on your main domain or subdomain. For example, **http://localhost or yourdomain.dev.** It **CANNOT** be installed in the subdirectory path of your domain, for example, **yourdomain.dev/my-app or localhost/my-app.**

If your app directory is not the same as the server root directory, consider [creating a virtual host](#create-a-virtual-host-optional).
{% endhint %}

#### Step 4

Now visit [http://localhost/install](http://qwiktest.test/install) on the browser and follow the installation instructions.

![Installer Start Screen](https://3791649983-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mb1ofvkThROm6pwq71N%2F-Mf3jAbqI0dw1Js-Ky6C%2F-Mf3k2RtC-o_5FvsYH69%2Finstallation-screen.jpg?alt=media\&token=588681ee-e8a0-44c0-a826-b14c071b0739)

![Requirements Screen](https://3791649983-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mb1ofvkThROm6pwq71N%2F-MfSL_0toMJZXFDkdQKJ%2F-MfSMAeijTXJrArmQcfV%2Frequirements-screen.jpg?alt=media\&token=05b2cb01-ce76-4eb4-a7cc-0c0db3891973)

![Permissions Screen](https://3791649983-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mb1ofvkThROm6pwq71N%2F-MfSL_0toMJZXFDkdQKJ%2F-MfSMIRi8VOIh_7D7I0R%2Fpermissions-screen.jpg?alt=media\&token=f2b6e6a0-716e-4d1b-a750-280004f21aee)

![Configuration Screen](https://3791649983-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mb1ofvkThROm6pwq71N%2F-MfSL_0toMJZXFDkdQKJ%2F-MfSMryNpoQG2gvsTNL4%2Fconfiguraction-screen.jpg?alt=media\&token=4621bbc1-73f3-4ee9-b400-6bda51fbee5a)

{% hint style="danger" %}
We suggest using Form Wizard Setup for editing environment settings. If you are using Classic Text Editor for editing Environment Settings, please make sure you click on the Save .env button after editing the .env file and before proceeding to the further installation.
{% endhint %}

![Environment Screen](https://3791649983-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mb1ofvkThROm6pwq71N%2F-MfSL_0toMJZXFDkdQKJ%2F-MfSNAJIi44WkQG33yQW%2Flocal-environment-screen.jpg?alt=media\&token=9c077e77-9f76-4ea8-95ca-9fa372c3a458)

![Database Screen](https://3791649983-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mb1ofvkThROm6pwq71N%2F-MfSL_0toMJZXFDkdQKJ%2F-MfSNFGZ1LtMLiztb3a0%2Fdatabase-screen.jpg?alt=media\&token=a3b2862d-1325-467c-ab47-e059a4131659)

![Install](https://3791649983-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mb1ofvkThROm6pwq71N%2F-MfSL_0toMJZXFDkdQKJ%2F-MfSNM2qMQAcXlzDjY55%2Fapplication-screen.jpg?alt=media\&token=0421478a-7be5-4af7-aaa9-a8ea1a0b9e90)

#### Final Step

Finally, when you are on the installation success screen, don't close the browser window directly. Instead, you must hit the **Click here to exit** the button to complete the installation.&#x20;

![](https://3791649983-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mb1ofvkThROm6pwq71N%2F-Mf3jAbqI0dw1Js-Ky6C%2F-Mf3kP_ja5e7RkPbtPhL%2Fsuccess-screen.jpg?alt=media\&token=ee5876b1-9852-4cd3-b9cf-d248290be9be)

{% hint style="danger" %}
If the installation fails due to server issues, fix them and:&#x20;

1. Delete all the tables in the existing database or make a new database.
2. Delete the **storage/installed** file of the app in the sever
3. Replace the .env file on the server with the .env file from the downloaded script.
4. Finally, start the installation again by visiting **yourdomain.com/install**.
{% endhint %}

### Create a Virtual Host (Optional)

If you want to configure a virtual host instead of localhost in the URL, you can create a virtual host in the Apache virtual hosts configuration file.

Open the `C:\xampp\apache\conf\extra\httpd-vhosts.conf` file and paste the below configuration into it.

```
<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/public"
    ServerName yourdomain.dev
</VirtualHost>
```

{% hint style="warning" %}
If your installation is in a different path, change **DocumentRoot** according to your application path.&#x20;

You should set the document root to the app's **/public** directory, not the root directory. If you set it to the root directory, it won't work.
{% endhint %}

Now you need to update your Windows hosts file. Open`C:\Windows\System32\drivers\etc\hosts` file and add the following line to it.

```
127.0.0.1 yourdomain.dev
```

![](https://3791649983-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mb1ofvkThROm6pwq71N%2F-MfHk_Lrlh_uM_0KwRvx%2F-MfHlZiRNhbz_2qRjKpR%2Fvirtual-host-in-window10.png?alt=media\&token=6e54acd8-464e-41e1-871d-af7cd066ed3f)

Now, restart the Apache from the XAMPP control panel.

{% hint style="danger" %}
If you configure the virtual host after installation, manually edit the .**env** file in the application root folder and replace the APP\_URL property with the new host.

Eg: `APP_URL=http://localhost` to `APP_URL=http://qwiktest.test`
{% endhint %}

### Installation Support

{% hint style="info" %}
Please raise a ticket on our support portal if you have any issues with the installation within the QwikTest application.
{% endhint %}

{% hint style="danger" %}
We cannot provide fixes that are related to your web hosting or server environment. Therefore, if your hosting or server environment is different than what is listed in the above section, you’ll need to determine if it will work before purchasing. Server setup and configuration are not in our scope of support.
{% endhint %}
