Follow this step-by-step guide to install and configure OmniMart Pro. The interactive web installation wizard works identically for both local development workspaces (localhost) and production web hosting servers.
Step-by-Step Installation Process
Step 1: Upload & Extract Files
- After purchasing and downloading OmniMart Pro, locate the
installable.zipfile inside your downloaded package. - Upload
installable.zipto your target directory:- Production Server (cPanel): Upload to
public_htmlor your domain's document root. - Localhost: Place in your local web directory (e.g.
www/for Laragon/Herd orhtdocs/for XAMPP).
- Production Server (cPanel): Upload to
- Extract the zip archive completely.
- Open your web browser and navigate to your website's URL (e.g.,
https://yourdomain.com). - You will automatically be redirected to the web installer Welcome screen (
/install).
Step 2: Welcome & Requirements Verification
- On the Welcome page of the installation wizard, click Check Requirements.
- The installer will inspect your server environment against all required PHP version rules and required PHP extensions.
- Verify that all requirements show a green checkmark.
- Once all requirements are verified, click Continue to Permissions.
Step 3: Directory Permissions Verification
- The installer will check write access for the core application storage and cache directories:
storage/app/storage/framework/storage/logs/bootstrap/cache/
- Ensure that each directory displays a green Writable status.
- Once all permissions are verified, click Continue to License Setup.
Step 4: License Verification
Verify your product purchase license to activate your OmniMart Pro installation:
- Email Address: Enter your geniusdevs.com user account email address (the registered email address associated with your GeniusDevs account).
- GeniusDevs License Key: Enter your unique license key / purchase code (provided in your GeniusDevs customer dashboard or CodeCanyon purchase receipt).
- Active Internet Connection: Ensure your web server has an active internet connection to communicate with the GeniusDevs central verification server.
- Click Verify License.
Important: GeniusDevs licenses follow a single-domain policy. Each license key is valid for one live domain installation only. If you need to transfer your license to a new domain, contact customer support for authorization.
- Once verification is successful, the installer automatically advances to Step 5: Environment Setup & Database Installation.
Step 5: Environment Setup & Database Installation
On the Environment Setup page, configure your application details, database connection, and custom administrator credentials:
- Application Settings:
- App Name: Enter your store name (e.g.,
OmniMart Pro). - App URL: Enter your full URL including protocol (e.g.,
https://yourdomain.com).
- App Name: Enter your store name (e.g.,
- Database Connection:
- Database Host: Usually
127.0.0.1orlocalhost. - Database Port: Standard MySQL port
3306. - Database Name: The name of your newly created database.
- Database Username: Database user (e.g.,
rooton localhost or your cPanel DB user). - Database Password: Password for the database user.
- Database Host: Usually
- Administrator Credentials:
- Set your custom Admin Email and Admin Password (these fields are required and will be used to access the admin panel immediately after installation).
- Click Test Database Connection to confirm connectivity.
- Once the test succeeds, click Save & Install. The installer will write your
.envfile, run database migrations, seed default records, create your administrator account, and finalize setup.
Step 6: Dashboard Login & Security Setup
Upon successful completion, you will redirect to the installation confirmation screen:
Click the Admin Dashboard button to navigate to the backend login page (/admin).
Administrator Login Credentials:
- Login URL:
https://yourdomain.com/admin- Email: The custom administrator email configured in Step 5.
- Password: The custom administrator password configured in Step 5.
Security Recommendation: You can update your profile credentials and security settings at any time from the Admin Profile page.
Step 7: Background Workers & Scheduler (Cron Jobs)
OmniMart Pro uses automated background tasks to process queued email notifications, handle scheduled campaign discounts, and keep system routines in sync.
Localhost Setup (Development & Testing)
On localhost, you do not need to configure a system cron service. To run background jobs during testing, execute the following command in your project terminal:
# Start background queue worker to process email templates and jobs
php artisan queue:work
Production Setup — Choose Method A or Method B
Method A: CLI Cron Jobs (VPS / Dedicated Server / SSH Access)
If your server provides SSH access or terminal crontab management, add these cron entries to your server crontab (crontab -e):
# Laravel Scheduler — runs scheduled system tasks every minute
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1
# Queue worker — processes emails & background jobs safely, then exits
* * * * * cd /path-to-your-project && php artisan queue:work --stop-when-empty --queue=default,emails --tries=3 >> /dev/null 2>&1
Method B: Web-Based Cron URL (Shared Hosting / cPanel / Plesk)
OmniMart Pro features a built-in, token-protected Web Cron URL specifically designed for shared hosting environments where continuous daemon queue workers cannot run.
Your unique cron URL is automatically generated from your application key and is displayed in Admin Panel → Manage Site → Cron Job (/admin/setting/cron).
https://yourdomain.com/cron/{your-secret-token}
cPanel Cron Setup Steps:
- In your Admin Panel → Manage Site → Cron Job, copy your Cron Job URL.
- Log in to your cPanel dashboard and open Cron Jobs.
- Set the interval to Once Per Five Minutes (
*/5 * * * *) or Once Per Minute (* * * * *). - In the Command field, enter:
Or ifBASH
wget -q -O /dev/null "https://yourdomain.com/cron/{your-secret-token}"wgetis disabled on your server:BASHcurl -s "https://yourdomain.com/cron/{your-secret-token}" > /dev/null 2>&1 - Click Add New Cron Job.
Important for Shared Hosting: Daemon queue processes (
php artisan queue:workwithout--stop-when-empty) are terminated by shared hosting process monitors. Method B safely dispatches scheduled tasks and flushes pending queue tasks in a single HTTP request.