Quickqr Contactless Restaurant QR Menu Maker

Quickqr Contactless Restaurant QR Menu Maker

Complete Installation & Setup Guide on cPanel & VPS (2026)

1. Overview

The Quickqr Contactless Restaurant QR Menu Maker is a modern PHP Laravel 10 application that lets restaurants generate QR‑coded menus in seconds. It ships with a clean MySQL schema, Bootstrap 5 UI, and jQuery‑enhanced admin panel. This guide walks you through a production‑ready installation on both cPanel shared hosting and VPS (Apache or Nginx) environments, covering:

• Server prerequisites
• Database creation & migration
• File‑system permissions (chmod 775)
• Apache & Nginx virtual‑host configuration
• Common pitfalls and troubleshooting

2. Server Requirements

3. Preparing the Environment

3.1. Accessing Your Server

• cPanel – Log in to https://yourdomain.com/cpanel. Use File Manager and Terminal (or SSH if enabled).
• VPS – SSH into the server:

ssh root@your-vps-ip

3.2. Installing Required Packages (VPS)

# Update repository cache
apt update && apt upgrade -y

# Install PHP 8.2 + extensions
apt install -y php8.2 php8.2-cli php8.2-fpm php8.2-mbstring php8.2-xml php8.2-bcmath php8.2-json php8.2-ctype php8.2-tokenizer php8.2-pdo php8.2-mysql php8.2-fileinfo

# Install Composer
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
rm composer-setup.php

# Install MySQL (or MariaDB)
apt install -y mysql-server

4. Database Creation

4.1. Create a Dedicated Database & User

-- Log into MySQL as root
mysql -u root -p

-- Create database
CREATE DATABASE quickqr_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Create user with strong password
CREATE USER 'quickqr_user'@'localhost' IDENTIFIED BY 'StrongP@ssw0rd!';

-- Grant privileges
GRANT ALL PRIVILEGES ON quickqr_db.* TO 'quickqr_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

4.2. Update .env

Copy the sample environment file and edit the DB credentials:

cp .env.example .env
nano .env   # or use any editor

APP_NAME="Quickqr Contactless Restaurant QR Menu Maker"
APP_ENV=production
APP_KEY=   # will be generated later
APP_DEBUG=false
APP_URL=https://yourdomain.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=quickqr_db
DB_USERNAME=quickqr_user
DB_PASSWORD=StrongP@ssw0rd!

5. Deploying the Code

5.1. Upload Files

• cPanel – Use File Manager → Upload or FTP (e.g., FileZilla) to place the extracted script into public_html/quickqr.
• VPS – Clone from your repository or upload via scp:

scp -r /local/path/quickqr root@your-vps-ip:/var/www/quickqr

5.2. Set Correct Permissions

cd /var/www/quickqr
# Directories need write access for Laravel
find . -type d -exec chmod 775 {} \;
# Files should be readable
find . -type f -exec chmod 664 {} \;
# Storage & bootstrap/cache must be writable by web server
chmod -R 775 storage bootstrap/cache

5.3. Install Composer Dependencies

composer install --optimize-autoloader --no-dev

5.4. Generate Application Key

php artisan key:generate

5.5. Run Migrations & Seeders

php artisan migrate --force
php artisan db:seed --force   # optional, loads demo data

6. Web‑Server Configuration

6.1. Apache (cPanel or VPS)

Create a virtual host file (VPS) or use cPanel’s Domain > Apache Handlers.

<VirtualHost *:80>
    ServerName quickqr.yourdomain.com
    DocumentRoot /var/www/quickqr/public

    <Directory /var/www/quickqr/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/quickqr_error.log
    CustomLog ${APACHE_LOG_DIR}/quickqr_access.log combined
</VirtualHost>

Enable the site and reload Apache:

a2ensite quickqr.conf
systemctl reload apache2

6.2. Nginx (VPS)

Create a server block:

server {
    listen 80;
    server_name quickqr.yourdomain.com;
    root /var/www/quickqr/public;

    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_intercept_errors on;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }

    access_log /var/log/nginx/quickqr_access.log;
    error_log /var/log/nginx/quickqr_error.log;
}

Enable and test:

ln -s /etc/nginx/sites-available/quickqr.conf /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

7. Common Installation Pitfalls

8. Post‑Installation Checklist

1. 1
   SSL/TLS – Install a free Let’s Encrypt certificate (certbot) and force HTTPS in your virtual host.
2. 2
   Cache & Optimizations – Run php artisan config:cache, php artisan route:cache, php artisan view:cache.
3. 3
   Queue Worker (optional) – If you enable email or SMS notifications, start a supervisor process:

   apt install -y supervisor
   cat > /etc/supervisor/conf.d/quickqr-worker.conf <<EOF
   [program:quickqr-worker]
   process_name=%(program_name)s_%(process_num)02d
   command=php /var/www/quickqr/artisan queue:work --sleep=3 --tries=3
   autostart=true
   autorestart=true
   numprocs=1
   user=www-data
   redirect_stderr=true
   stdout_logfile=/var/log/quickqr/worker.log
   EOF
   supervisorctl reread && supervisorctl update

1. 1
   Backup Strategy – Schedule nightly mysqldump and file system snapshots.

9. SEO‑Friendly Deployment Tips

• Canonical URLs: Add <link rel="canonical" href="https://yourdomain.com/"> in the <head> of the menu pages.
• Schema.org RestaurantMenu: Embed JSON‑LD to help search engines understand the QR‑menu content.
• Fast Loading: Enable GZIP compression (AddOutputFilterByType DEFLATE text/html text/css application/javascript) and leverage browser caching (expires max).
• Mobile‑First Design: Bootstrap 5 already provides responsive layouts; test with Google’s Mobile-Friendly Test.

10. Frequently Asked Questions

Q1: Can I install Quickqr on a shared cPanel host that only offers PHP 8.0?

A: Laravel 10 requires PHP 8.1+. If your host cannot upgrade, you’ll need to switch to a VPS or a newer shared plan. Attempting to run the script on PHP 8.0 will result in fatal errors during Composer install.

Q2: How do I migrate the database when I release a new version of Quickqr?

A: Laravel’s migration system handles schema changes. After pulling the new code, run:

php artisan migrate --force

If you need to roll back a specific migration:

php artisan migrate:rollback --step=1

Always backup the database before running migrations on production.

Q3: Is the source code truly clean and untouched?

A: Yes. Developers can order the verified clean untouched source code with instant on‑demand delivery for a flat $5.00 rate via 217G. The package includes the original Laravel project, Composer lock file, and all front‑end assets—no hidden modifications.

11. Final Thoughts

Deploying **Quick