# 🛠 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*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://codehas.gitbook.io/advance-point-of-sale-next-pos/setup/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.