> 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/requirments.md).

# ⚙️ System Requirements

Before installing Advance Point of Sale – Next POS, make sure your hosting environment meets the minimum system requirements listed below. These ensure proper installation, security, and long-term performance.

***

### ✅ Server Requirements

| Component  | Minimum Requirement           |
| ---------- | ----------------------------- |
| PHP        | Version 8.1                   |
| Database   | MySQL 5.7+ or MariaDB 10.2.7+ |
| Web Server | Apache (preferred)            |

> 💡 *While Apache is recommended, the system also works with Nginx or other servers—provided PHP and URL rewriting are properly configured.*

***

### 🧩 Required PHP Extensions<br>

The following extensions must be enabled on your server:

| Extension | Purpose                                |
| --------- | -------------------------------------- |
| bcmath    | Math operations and Laravel support    |
| ctype     | String validation and input handling   |
| fileinfo  | File uploads and MIME type detection   |
| json      | JSON data parsing                      |
| mbstring  | UTF-8 and multibyte string support     |
| openssl   | HTTPS encryption and security          |
| pdo       | Database communication via Laravel ORM |
| tokenizer | Syntax parsing and route handling      |
| xml       | XML-based configuration tools          |
| zip       | Backup and archive creation            |
| gd        | Label printing and image rendering     |
| iconv     | Character encoding conversions         |
| simplexml | Reading XML files                      |
| xmlreader | Efficient XML parsing                  |
| zlib      | Compression for backups and exports    |

> 🚨 *If any of these are missing, please contact your hosting provider or server administrator to enable them before proceeding with the installation.*

***

### 🧱 Built with Laravel

Advance POS is built on the Laravel PHP Framework—renowned for its performance, flexibility, and modern security practices. All hosting environments must support Laravel’s typical runtime dependencies.

***

### 🌍 Recommended Hosting Environments

✅ Shared Hosting (with PHP 8.1+ & Laravel support)

✅ VPS or Dedicated Server

✅ Cloud Hosting (e.g., DigitalOcean, Hostinger, Namecheap)<br>

❌ Localhost setups are not supported (e.g., XAMPP, WAMP, Laragon)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/requirments.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.