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

---

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.

---

❗ Important Notes

• ✅ Live Server Only: Installer works on production servers only—not local environments.

• 🔒 No Support for Local Setup: Hosting installs get full tech support; local setups do not.

• 🧠 Single Domain Use: License covers one domain/subdomain per purchase. Transfers are allowed during active support.

---

💬 Need Help?

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