# 🛠 Installation Guide

Get your Advance Point of Sale – Next POS system up and running in just a few easy steps. Follow this guide to go from download to a live, fully functional POS application in no time.

***

### 1. 📂 Upload & Configure Document Root

* Extract the downloaded ZIP package.
* Upload all files to your server (via FTP, cPanel File Manager, etc.).
* Make sure your domain or subdomain points to the /public folder.

{% hint style="success" %}
#### 🧩 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:

📩 [info.codehas@gmail.com](mailto:info.codehas@gmail.com)
{% endhint %}

Example:

If your site is pos.yourdomain.com, set the Document Root to:

```
/home/yourusername/pos/public
```

Shared hosting tip:

```
/home/yourusername/public_html/pos/public
```

#### 🔄 Alternate Setup (if Document Root can’t be changed)



If your hosting doesn’t allow root customization, add the following .htaccess in your main project folder:

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

This forwards all requests to the public directory safely.

***

### 2. 🗄 Create Your Database 

In your hosting control panel:

* Create a new MySQL or MariaDB database.
* Add a database user, grant all permissions.



📌 Save these details:

* Database Name
* Username
* Password
* Host (typically localhost)

***

### 3. 🚀 Run the Installer



Open your browser and visit:

```
https://yourdomain.com/install.php
```

* The installer will check your server for required extensions and settings.
* Enter your database details and desired admin credentials.
* Click Begin Install to start the process.\


If everything’s correct, you’ll be redirected to the login screen.

***

### 4. 🔐 Log In & Secure Your Setup



Default Admin Credentials:

* Email: admin@admin.com
* Password: 12345678



👉 Important: After your first login, go to Users → Edit and change the email and password.

***

### 5. ⚙️ Post-Install Configuration

Head to Settings → App Configs to:

* Set up currency, tax rates, invoice branding
* Configure email & SMS gateways, WhatsApp integration, and printer settings
* Tweak POS behavior, enable/disable features like QR codes, cash tracking, and more\


🧪 Pro tip: Run a test sale to verify.

* Barcode scanner works
* Receipt prints correctly
* Notifications are delivered

***

### 💬 Need Help?

If you hit a roadblock, reach out:

📩 info.codehas@gmail.com

⏳ Typical response time: _up to 2 business days_
