🛠️ 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

.htaccess

(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	[e-mail]	12345678
Technician	[e-mail]	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 →

---

🆘 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

⏱️ Response time: Up to 2 business days