localhost Installation

For development on Windows, macOS, or Linux using XAMPP, WAMP, Laragon, MAMP, or a native LAMP/LEMP stack.

⚠️ Important: BotMerze requires PostgreSQL 16 + pgvector. XAMPP/WAMP ship MySQL by default — install PostgreSQL separately.

Step 1 — Install Local Stack

Windows: XAMPP (PHP 8.3+) or Laragon + PostgreSQL 16 with pgvector.
macOS: brew install [email protected] postgresql@16 pgvector composer
Linux: native LAMP/LEMP — see VPS Installation Guide, Step 2.

php -v
composer --version
psql --version

Step 2 — Extract the Project

Download BotMerze from CodeCanyon, extract, and locate the installable ZIP inside Installable File/.

Step 3 — Place Files

XAMPP: put folder under htdocs/botmerze/.
Laragon: put folder under C:\laragon\www\botmerze\.
macOS/Linux: any path served locally (e.g. ~/Sites/botmerze).

Step 4 — Create the Database

CREATE DATABASE botmerze;
CREATE USER botmerze_user WITH PASSWORD 'localdevpass';
GRANT ALL PRIVILEGES ON DATABASE botmerze TO botmerze_user;
\c botmerze
CREATE EXTENSION IF NOT EXISTS vector;

Step 5 — Run the Installer

Open:

http://localhost/botmerze/

(Laragon: typically http://botmerze.test/.)

Walk through the wizard:

License (Envato username + purchase code).
Server requirements — fix any red items in php.ini (extension=pdo_pgsql, extension=pgsql, extension=gd) and restart your stack.
Folder permissions — ensure core/storage/ and core/bootstrap/cache/ are writable.
Database:Host: 127.0.0.1 Port: 5432 Database: botmerze User: botmerze_user Password: localdevpass
Admin info.
Install Now.

Step 6 — Login

http://localhost/botmerze/admin/login

Step 7 — Generate Chatbot Secret

cd core
php artisan chatbot:generate-secret-key

Local-Only Tips

Enable mod_rewrite (XAMPP/Apache) in httpd.conf.
Blank page? Set APP_DEBUG=true in core/.env and check core/storage/logs/laravel.log.
Pretty URLs not working? Confirm .htaccess is present and AllowOverride All is set for the project folder.