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

⚠️ Note: This application is intended for live web servers only. Localhost installations (e.g., XAMPP, WAMP) are not supported and may result in unexpected behavior.


✅ 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


📁 Uploading Files

  1. Download the main .zip file from your CodeCanyon account.

  2. Extract it locally to access the contents.

  3. Locate backend-source.zip inside the package.

  4. Upload application files as a zip to your domain or subdomain directory via cPanel or FTP.

  5. Once uploaded, extract the ZIP file on the server.


🌐 Installation Steps

Once files are uploaded and extracted:

Open the installer by visiting:

https://yourdomain.com/install

The setup wizard will guide you through:

  • ✅ License Verification: Ensure your domain has HTTPS and internet access.

  • 🔧 Database Configuration: Input database name, user, password, and host (usually localhost).

  • 🌍 App Settings: Configure basic app info like name, timezone, and currency.


🛠️ Finishing Up

Once setup is complete:

  • You’ll be redirected to the login page.

  • Use the default credentials:

    • Email: admin@admin.com

    • Password: 12345678

Make sure to change the login details immediately after first access.


🧯 Troubleshooting & Tips

Issue

Possible Fix

White page

Check file permissions and PHP version

404 not found

Ensure .htaccess exists and mod_rewrite is enabled

License error

Confirm HTTPS and active internet connection

Installer not loading

Check file upload path and permissions

💡 For best results, install on cPanel with SSL enabled.


📦 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