Install KitConnect
Install KitConnect in the correct store web root, verify access when needed, troubleshoot Not connected, and remove the package after migration work is complete.
Install KitConnect
Section titled “Install KitConnect”Install KitConnect only when the Connect Stores step assigns KitConnect to the Source Store, Target Store, or both. Each store that uses KitConnect requires its own package and installation.
KitConnect is temporary. For architecture, scope, and connection-model background, see Understanding KitConnect.
Before you start
Section titled “Before you start”You need:
- access to the active migration as the owner or through Delegate Access;
- SFTP, FTP, or hosting File Manager access.
If you need to identify the directory that serves the store domain, use Locate the Website Web Root Folder. For SFTP, FTP, hosting File Manager, upload, or ZIP-extraction instructions, use Use File Transfer Tools.
Required placement
Section titled “Required placement”The store web root is the directory that directly contains the website source code, or the public directory within the source code when applicable. It is not the server /root directory. Common web-root names include public_html, htdocs, www, wwwroot, public, or pub.
Keep the generated KitConnect folder name unchanged and maintain this structure inside the store web root:
Directorypublic_html/
- index.php
Directorykitconnect_xxxxxx/
- kitconnect.php
- …
In this example, we assume public_html is the website’s root directory. Your root directory name may differ depending on your web server configuration.
Install KitConnect
Section titled “Install KitConnect”- In the Connect Stores step, enter the Store URL for the store assigned KitConnect.
- Download
kitconnect.zipfor that store. - Extract the archive. Keep the generated directory structure, file names, and folder name unchanged so
kitconnect.phpremains insidekitconnect_xxxxxx. - Upload the complete extracted
kitconnect_xxxxxxfolder to the store web root through SFTP, FTP, or hosting File Manager. If you uploadkitconnect.zipthrough hosting File Manager instead, extract it in that same web root without renaming or restructuring its contents. - If the other store also uses KitConnect, repeat the Store URL, download, extraction, and upload process for that store.
- Use Test Connection when you want to verify access before continuing. If it returns Connected, no separate browser or application-level check is required. If access fails, Next-Cart displays a pop-up notification and Not connected beside the affected platform.
For a visual upload walkthrough, see Upload KitConnect via FTP and cPanel.
If Test Connection returns Not connected
Section titled “If Test Connection returns Not connected”Use these checks only for the affected store after Not connected appears.
| Check | What to do |
|---|---|
| KitConnect folder or file is missing | Both the kitconnect_xxxxxx directory and the kitconnect.php file need to be uploaded. Ensure that the file is located inside the folder. Re-upload the complete extracted folder if the structure is incomplete. |
| Wrong store web root | Store web root is not the /root directory. It is the directory directly containing your website’s source code, or the public directory within the source code (if applicable). Use Locate the Website Web Root Folder to identify it, then move or re-upload the complete KitConnect folder there. |
| KitConnect URL returns 404 | Confirm that the domain points to the intended store web root and that the URL uses the actual generated KitConnect folder name. |
| WAF, CDN, Cloudflare, or bot protection blocks the KitConnect URL | Follow Cloudflare, WAF, or CDN blocks KitConnect and apply only the access change required for the KitConnect URL. |
| Web server blocks direct access to the KitConnect URL | Review Nginx blocks the KitConnect endpoint when it matches the server setup, or have the hosting administrator allow access to the KitConnect URL without weakening unrelated server protections. |
| KitConnect URL is reachable but the connection still fails | Recheck the Store URL, actual KitConnect folder name, affected Source or Target Store, and values shown in the Connect Stores step, then retry only that store if needed. |
For diagnosis after Not connected, use the actual generated folder name in this KitConnect URL pattern:
https://your-domain.com/kitconnect_xxxxxx/kitconnect.phpIf the connection still fails, use Troubleshoot Connection Setup for the full connection-recovery workflow.
Remove KitConnect after migration work
Section titled “Remove KitConnect after migration work”KitConnect is a temporary bridge used during migration. After the migration and required follow-up work are complete and accepted:
- Delete the KitConnect folder installed for this migration.
- Delete temporary
kitconnect.zipcopies from the server. - Confirm that the removed KitConnect path is no longer present on the server.
Removing KitConnect does not undo migrated data. If later migration activity requires KitConnect again, download the package supplied for that active migration instead of assuming an earlier package should be reused.
Next Steps
Section titled “Next Steps”After the required Source and Target setup is complete, continue to the Configuration step.