> For the complete documentation index, see [llms.txt](https://codehas.gitbook.io/advance-point-of-sale-next-pos/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codehas.gitbook.io/advance-point-of-sale-next-pos/setup/installation.md).

# 🛠 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>
{% 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<br>

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

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<br>

🧪 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*