🛠 Installation Guide

Get your Ultimate Repair Shop Solution up and running with ease. Just follow these streamlined steps to go from download to live application in no time.

---

🧩 Are you looking for a customized version?

We can provide a customized version tailored to your needs.

Please don’t hesitate to contact us at:

📩 [e-mail]

1. 📂 Upload & Configure Document Root

1. Extract and upload all files to your server (via FTP, cPanel, etc.).

2. Important: Point your domain/subdomain’s Document Root to the public/ folder:

   • Example: If your site is pos.yourdomain.com, set Document Root to /home/username/pos/public.

   • Tip: On shared hosting, it might look like /home/username/public_html/pos/public.

If your host doesn’t allow custom roots, add this .htaccess at your project’s root:

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

This reroutes all requests to public/ so your site loads securely and correctly.

---

2. 🗄 Create Your Database

• Log in to your hosting control panel and set up a MySQL or MariaDB database.

• Create a database user, give it all privileges, and note down:

  • Database Name

  • Username

  • Password

  • Host (usually localhost)

---

3. 🚀 Run the Installer

1. In your browser, run:

   https://yourdomain.com/install.php

2. The installer checks that your server meets requirements (PHP, extensions, DB).

3. Fill in your database info and admin account credentials.

4. Click Begin Install. If all goes well, you’ll be redirected to the login page.

---

4. 🔐 Log In & Secure Your Setup

• Default Admin Login:

  • Email: [e-mail]

  • Password: 12345678

👉 Upon first login, immediately change the admin email/password via Users → Edit.

---

5. 🧩 Post-Install Tips

• Navigate to Settings → App Configs to configure:

  • Currency, taxes, and POS behavior

  • Email/SMS gateways, printer settings, ReCAPTCHA

  • Invoice terms and branding details

• Enable or disable features like cash register tracking, QR codes, and more via Settings → POS Configs.

• Run a quick test order to ensure barcode scanning, label printing, and notifications are working as expected.

---

💬 Need Help?

• Encounter a snag? Reach out at [e-mail]. Response time up to 2 business days.