Installation Guide

Step-by-step guide for quick setup of AI Search in your OpenCart store

System Requirements

Make sure your hosting environment meets these requirements before installing.

Minimum Requirements

OpenCart 4.0 or higher
PHP 8.0 or higher
MySQL 5.7+ / MariaDB 10.3+
50MB free space
cURL extension enabled
allow_url_fopen = On

Step-by-Step Guide

Follow these steps to install and configure AI Search.

Get the module and license key

After registration and payment you will receive via email:

Module file (aisearch.ocmod.zip)
License key
Installation guide PDF

Create a backup

Important

Always create a full backup of your database and files before installing any new module. This ensures you can restore your store if anything goes wrong during installation.

Install the module via admin panel

3.1

3.2

Go to Extensions → Installer

3.3

Click "Upload" and select aisearch.ocmod.zip

3.4

Wait for the upload to complete (green checkmark will appear)

3.5

Go to Extensions → Extensions, then select Modules from the dropdown

3.6

Find "AI Search" in the list and click Install

3.7

Click "Edit" to open the module configuration page

Configure the module

General Tab

Set module status to Enabled
Select the store
Choose search languages
Configure search result limits

License Tab

Enter your license key
Click Validate
Confirm activation status
Save settings

Start indexing

Go to the Indexer tab and click Start Indexing. The module will process all your products and create semantic vectors for intelligent search.

Do not close your browser while indexing is in progress. The process may take a few minutes depending on the number of products in your catalog.

Test search functionality

Once indexing is complete, test the search on your storefront. Try these examples:

Typo tolerance

"notbok" → "notebook"

Synonyms

"smartphone" → "mobile phone"

Context

"warm clothes" → "jackets"

Common Issues

Quick solutions to the most frequently encountered problems.

• Ensure the file is a valid .ocmod.zip archive and not corrupted.
• Check that the storage/ directory has write permissions (755 or 775).
• Verify PHP upload_max_filesize is at least 10MB.
• Try clearing the OpenCart cache and re-uploading.

• Double-check that the license key is copied correctly without extra spaces.
• Ensure your server can reach api.aisearch.pro (cURL enabled, no firewall blocking).
• The domain in your license must match the store URL configured in OpenCart.
• Contact support if the issue persists.

• Make sure the license is validated and active.
• Check that allow_url_fopen is enabled in php.ini.
• Verify max_execution_time is at least 300 seconds.
• Check the OpenCart error log for detailed messages.

What's Next?

Explore more resources to get the most out of AI Search.

Documentation

Detailed guides on configuration, API usage, and advanced features.

FAQ

Answers to frequently asked questions about AI Search features and usage.

Contact Us

Need help? Our support team is ready to assist you with any questions.

Self-hosted Installation

The self-hosted version allows you to run the AI Search engine on your own infrastructure. This option is ideal for businesses that require full data control, custom model training, or integration with private networks.

Additional Requirements

Linux server (Ubuntu 22.04+ recommended)
Docker & Docker Compose
Minimum 4 GB RAM, 2 CPU cores
GPU recommended for faster indexing (optional)
Redis 6+ for queue management

Detailed self-hosted installation instructions, Docker configuration, and architecture overview are available in the documentation.

View Documentation Contact Sales