# 🛠️ Installation Guide

Installing Repair Box is quick and straightforward when using a live server. This guide will walk you through the full installation process step by step.\


> ⚠️ Note: Repair Box does not support installation on localhost environments (such as XAMPP, WAMP, Laragon, etc.). It must be installed on a live web server (shared, VPS, or dedicated).

***

### 📂 1. Set the Document Root

\


After purchasing and extracting the installation package:

* Upload all files and folders to your domain or subdomain directory (via cPanel or FTP).
* Navigate to your domain’s Document Root settings and append /public to the root path.

\


Example:

\


If your subdomain is:

```
repairbox.codehas.net
```

Then the correct document root should be:

```
/home/youruser/public_html/repairbox.codehas.net/public
```

📌 This ensures the application correctly points to the Laravel /public folder for secure routing.

***

### 🧭 Alternate Setup via&#x20;

### .htaccess

### &#x20;(Optional)

\


If you prefer not to modify the document root manually:

1. In the root of the application (same folder as .env, not /public), create a new file named .htaccess.
2. Paste the following code inside:

```
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteRule ^(.*)$ public/$1 [L]
</IfModule>
```

✅ This will redirect all incoming traffic to the /public folder.

***

### 🧬 2. Upload the Files

* Upload the full Repair Box folder using cPanel File Manager or an FTP client like FileZilla.
* If installing into a subfolder, make sure folder names contain no spaces.

***

### 🗃️ 3. Create a MySQL Database

\


Create the following via your hosting control panel:

* A new MySQL database
* A new database user
* Grant ALL privileges to the user on the new database

\


Take note of your database name, username, and password — you’ll need them during installation.

***

### 🌐 4. Begin the Web Installer

\


Visit:

```
http://repairbox.codehas.net/install.php
```

🔎 The installer will automatically check for required PHP extensions. If any required items are missing, the system will alert you before continuing.

***

### 🧾 5. Installation Steps

1. Enter your server and database credentials when prompted.
2. Click “Begin” to start the installation.
3. Once complete, the system will redirect you to the login page.

***

### 🔐 Default Login Credentials

\


You can use the following credentials to access the system after installation:

| Role       | Email           | Password |
| ---------- | --------------- | -------- |
| Admin      | admin@admin.com | 12345678 |
| Technician | user@user.com   | 12345678 |

> 🛡️ Important: After your first login, update your email and password via the User Management section.

***

### 📢 Post-Installation Setup

\


After installation, be sure to configure your notification templates for emails and SMS.

🔗 [View Notification Template Setup Guide →](https://codehas.gitbook.io/repair-box/faq#how-can-set-notification-templates-for-email-and-sms-notifications)

***

### 🆘 Need Help?

\


If you face any issues during installation:

* Check server permissions and file ownership
* Review PHP version and enabled extensions
* Contact [Repair Box Support](mailto:info.codehas@gmail.com)

\


> ⏱️ Response time: Up to 2 business days
