⚙️ 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.


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

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

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,

Let's see a common way to create a MySQL database and read more common information related to the database.

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

  • 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

  • Enter your database information and click on save.

  • Click on Complete Installation and wait for a while.

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.


Last updated