> For the complete documentation index, see [llms.txt](https://codehas.gitbook.io/restaurant-pos-pro/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/restaurant-pos-pro/get-started/installation-guide.md).

# ⚙️ Installation Guide

This section will guide you through installing Restaurant POS Pro on a live server. The installer is beginner-friendly, and setup can be completed in just a few minutes.

{% hint style="danger" %}
⚠️ Note: No Support for local server.
{% endhint %}

***

### ✅ Server Requirements

Before starting, ensure your server meets the following:

* PHP 8.1 or later
* MySQL 5.7+ or MariaDB
* Apache/Nginx web server
* HTTPS-enabled domain or subdomain
* Enabled PHP extensions:
  * cURL, Mbstring, OpenSSL, PDO, Fileinfo, JSON, Tokenizer, XML
* Writable permissions on:
  * /storage
  * /bootstrap/cache

***

### 🌐 Installation Steps

Once you have downloaded the installation files after purchase, you simply need to add "/public" to your domain's "Document Root". path.

<figure><img src="https://1701705512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJYpDkVSaO95YKamONp0g%2Fuploads%2FkQGM9UBcWUQlx8GkJMZF%2Fimage.png?alt=media&amp;token=ab9ed42e-6d84-4c7d-a1e6-89e920132ab0" alt=""><figcaption></figcaption></figure>

Suppose in the above image **codehas. xyz** is your domain, you are going to create a subdomain which will be **smallpos.codehas.xyz,** and the **Document Root** will be **"smallpos.codehas.xyz"**.Here, the application needs to index the form directly to **"/public"**. So&#x20;

<figure><img src="https://1701705512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJYpDkVSaO95YKamONp0g%2Fuploads%2Frpie2DRHoFF1OvNhbiQg%2Fimage.png?alt=media&amp;token=9c6848ca-331f-4c94-9b92-2ffbdbbd2b78" alt=""><figcaption></figcaption></figure>

Simply add or append just `/public` in the document root as shown in the image below. This example demonstrates how a subdomain can be used to understand the document root path index. The document root should be indexed in the same way for the main domain.

\
Alternatively, you can create a single file (.htaccess) in the root directory of the application after uploading and extracting. The following lines should be written inside the file:\
File content for (with the name of .htaccess)

```

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

```

then hit create a subdomain,

{% hint style="info" %}
&#x20;Let's see a common way to [create a MySQL database](https://support.hostinger.com/en/articles/1583542-how-can-i-create-a-new-mysql-database) and read more common [information related to the database](https://support.hostinger.com/en/collections/944793-mysql-databases).
{% endhint %}

**Follow step by step:**

* Copy/Upload the folder and files to your web server using **cPanel** or FTP.
* If you are installing in a subfolder, please make sure there is no space in folder names.
* Create a MySQL database, a database user, and grant all permissions to use this database
* Open the `http://yourdomain.com/install.php` &#x20;
* Before installing the system will check the required list. If there is an issue with the checklist, you will need to fix it first to proceed to the next step

<figure><img src="https://1701705512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJYpDkVSaO95YKamONp0g%2Fuploads%2FzK1ioFx7MrlgJ2Wy4poI%2Fimage.png?alt=media&amp;token=8b1dd6f5-1c40-4a42-98d3-30e30ebac007" alt=""><figcaption></figcaption></figure>

* Enter your database information and click on save.

<figure><img src="https://1701705512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJYpDkVSaO95YKamONp0g%2Fuploads%2FefgTi3fEgFpeP6nL2VKd%2Fimage.png?alt=media&amp;token=1ed9b5f5-4c6d-441f-94d3-9364b9a15847" alt=""><figcaption></figcaption></figure>

* Click on Complete Installation and wait for a while.
*

```
<figure><img src="/files/LZYbQuxWAi5QkY46Zc0J" alt=""><figcaption></figcaption></figure>
```

<figure><img src="https://1701705512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJYpDkVSaO95YKamONp0g%2Fuploads%2FwoLSsMGjHZb0kxPiIeaa%2Fimage.png?alt=media&amp;token=abe18306-daaa-4d04-9ab0-bbc874ed6847" alt=""><figcaption></figcaption></figure>

The Installer will make sure that the required extensions are installed or not. If all required extensions are installed, fill in your server credentials and database information, and hit begin to install.

If your filled database credentials are correct installer will run and install. If everything goes smoothly, you will be redirected to the login page (use the default login details to log in).

**Default Login after installation:**

* **For Admin:** `admin@admin.com`
* **Password for all : `12345678`**

Log in by using the above default credentials, and don't forget to change your email/password from the user management

The setup wizard will guide you through:

* 🔧 Database Configuration: Input database name, user, password, and host (usually localhost).
* 🌍 App Settings: Configure basic app info like name, timezone, and currency.
* Set up your SMTP configuration,

***

### 📦 Post-Install Tasks

After login, we recommend:

* Changing the admin password
* Setting up food categories and items
* Testing printer and notification settings
* Creating a database backup
* Outgoing mail configuration must be configured.

***

{% hint style="danger" %}
Please change the hint type. If you encounter any issues during the installation process, contact item support. The author’s response time may take up to two business days.
{% endhint %}