# 🛠️ 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.<br>

> ⚠️ Note: No SUPPORT FOR LOCAL SERVER SETUP

***

### 📂 1. Set the Document Root

<br>

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.

<br>

Example:

<br>

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)

<br>

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

<br>

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

<br>

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

***

### 🌐 4. Begin the Web Installer

<br>

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

<br>

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

<br>

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?

<br>

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)

<br>

> ⏱️ Response time: Up to 2 business days


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://codehas.gitbook.io/repair-box/get-started/repair-box-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.