Use File Transfer Tools
Upload KitConnect or required files through SFTP, FTP, or hosting File Manager when Next-Cart setup requires server-side file placement.
Use File Transfer Tools
Section titled “Use File Transfer Tools”Place KitConnect or other required files in the correct server location without exposing credentials or using the wrong web root.
Most users should use SFTP when it is available. SFTP encrypts the connection between your computer and the server. Use FTP only when your hosting provider does not offer SFTP or when your internal team specifically approves FTP.
Prerequisites
Section titled “Prerequisites”Before using a file transfer option, confirm that you have:
| Requirement | Why it matters |
|---|---|
| Server access | You need SFTP, FTP, or hosting control panel access. |
| Hostname | The server address provided by your hosting provider. |
| Username and password or key | Credentials used to connect to the server. |
| Port | Commonly 22 for SFTP. Use the port provided by your host. |
| Web root path | The public folder where the store is installed, such as public_html, www, wwwroot, or httpdocs. |
| KitConnect or required files | The files you need to upload for the current setup. |
| Permission to upload files | The connected account must be allowed to write files to the target folder. |
Recommended upload location
Section titled “Recommended upload location”Upload KitConnect directly inside the store web root.
Directorypublic_html/
Directorykitconnect_abc123/
- index.php
- bridge.php
- files…
If your host uses a different web root name, use the folder that serves the public store domain.
Upload files with a transfer client or File Manager
Section titled “Upload files with a transfer client or File Manager”Use FileZilla when you have SFTP or FTP credentials and want a desktop transfer client.
- Open FileZilla.
- Enter the host value. For SFTP, use a value such as
sftp://sftp.example.comif your host provides that format. - Enter the username.
- Enter the password or use the approved key-based login option if your organization requires it.
- Enter the port. Use
22for SFTP unless your host provides a different port. - Connect to the server.
- In the local pane, open the folder on your computer that contains the files to upload.
- In the remote pane, open the store web root.
- Drag the file or folder from the local pane to the remote pane.
- Wait until the transfer queue shows that the upload completed.
- Confirm the uploaded files appear in the remote folder.
Use Cyberduck when you prefer a desktop client with a simple connection window.
- Open Cyberduck.
- Select Open Connection.
- Choose SFTP when your hosting provider supports SFTP.
- Enter the server hostname.
- Enter the port. Use
22for SFTP unless your host provides a different port. - Enter the username.
- Enter the password or approved key-based authentication details.
- Connect to the server.
- Open the store web root.
- Drag the required file or folder from your computer into the Cyberduck window.
- Wait for the transfer to complete.
- Confirm the uploaded files appear in the web root.
Use WinSCP when you are working from Windows and have SFTP, FTP, or SCP access.
- Open WinSCP.
- In the login window, choose SFTP when your host supports it.
- Enter the host name.
- Enter the port. Use
22for SFTP unless your host provides a different port. - Enter the user name.
- Enter the password or approved key-based authentication details.
- Connect to the server.
- In the remote pane, open the store web root.
- In the local pane, open the folder on your computer that contains the files to upload.
- Drag the required file or folder from the local pane to the remote pane.
- Confirm the transfer when prompted.
- Wait until the transfer completes and verify that the files appear in the remote folder.
Use cPanel File Manager when you prefer a browser-based upload path or do not have a desktop SFTP client available.
- Sign in to your hosting control panel.
- Open File Manager.
- Open the store web root, such as
public_html,www,wwwroot, orhttpdocs. - Select Upload.
- Choose the ZIP file or required file from your computer.
- Wait until the upload finishes.
- Return to File Manager and refresh the folder if needed.
- If you uploaded a ZIP file, select it and use Extract.
- Confirm the extraction location is the store web root.
- Verify that the extracted folder or files appear in the correct location.
Expected result
Section titled “Expected result”After upload:
- the required files are present in the correct web root;
- KitConnect is unzipped if the setup requires the unzipped folder;
- the file or folder name matches the value used in the URL or setup field;
- the transfer client or File Manager shows a completed upload;
- the uploaded path can be verified before connection testing.
Verify the upload
Section titled “Verify the upload”| Check | Pass condition |
|---|---|
| Correct server | You connected to the server for the intended source store or target store. |
| Correct web root | Files are uploaded under the folder that serves the public store domain. |
| Complete transfer | The transfer queue or upload screen shows the upload completed successfully. |
| ZIP extraction | If a ZIP file was uploaded, the extracted folder appears in the intended location. |
| Folder name | The folder name matches the URL or setup value you plan to enter in Next-Cart. |
| Browser check | If a public URL is expected, the URL opens without a 404 or permission error. |
| Permissions | Files and folders use normal host-approved permissions. |
If upload fails
Section titled “If upload fails”| Issue | What to check |
|---|---|
| Login fails | Check hostname, username, password, port, and whether the account requires SFTP or key-based login. |
| Connection times out | Confirm the server hostname, firewall rules, VPN requirements, and IP allowlist requirements. |
| Upload is denied | Confirm that the connected user can write to the selected folder. |
| Uploaded files are not visible | Refresh the remote pane or File Manager, then confirm you uploaded to the correct server and folder. |
| ZIP file does not extract | Confirm the ZIP file uploaded completely and that the hosting account has permission and disk space to extract it. |
| Browser URL returns 404 | Confirm the files are inside the correct web root and that the URL uses the correct domain and folder name. |
| Permission error appears | Check folder permissions and hosting security rules. Ask the hosting provider to confirm safe permissions if needed. |
| Wrong environment was updated | Confirm whether you connected to production, staging, development, or another server. |
Security guidance
Section titled “Security guidance”- Prefer SFTP over FTP when available.
- Use temporary credentials when possible.
- Do not share server passwords in unprotected messages.
- Do not store credentials in screenshots or support tickets.
- Remove uploaded ZIP files after extraction if they are no longer needed.
- Rotate temporary server credentials after migration work is complete and verified.
Next step
Section titled “Next step”| Situation | Go to |
|---|---|
| You uploaded KitConnect | Install KitConnect |
| Required files are uploaded and ready | Verify Platform Connections |
| Upload, extraction, permission, or URL checks fail | Troubleshoot Connection Setup |
| Platform connections are verified | Configure Your Migration |