๐Ÿ› ๏ธ 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: No SUPPORT FOR LOCAL SERVER SETUP


๐Ÿ“‚ 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

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 โ†’


๐Ÿ†˜ Need Help?

If you face any issues during installation:

  • Check server permissions and file ownership

  • Review PHP version and enabled extensions

โฑ๏ธ Response time: Up to 2 business days

Last updated