X
X

Select Your Currency

₺ Türk Lirası $ US Dollar
X
X

Select Your Currency

₺ Türk Lirası $ US Dollar

OpenCart Hosting Migration Guide: Move Your Store Safely

HomepageArticlesTechnical GuidesOpenCart Hosting Migration Guide: M...

When moving an OpenCart store to a new OpenCart hosting environment, the safest approach is to take a complete backup first, test the new server before changing the domain’s DNS record, and then perform a brief verification. In a shared hosting panel, a file manager and database tool may be sufficient; on a managed server, you may also need access to PHP, database, and web server settings.

What access and backups should you prepare before migration?

First, back up the existing store’s files and database separately. The file backup should include the OpenCart core files, theme, extensions, and uploaded images. The database backup contains products, orders, customers, and settings. Do not change or delete files on the existing server until you have confirmed that the backup can actually be read.

Also record the information required during the migration in advance: the new database name, username, server address, port information, and the DNS records that will be used for the domain. Do not share passwords in article comments, support forums, or publicly accessible error reports. The PHP version and enabled extensions used in the new environment must be compatible with the store’s OpenCart version and extensions; this compatibility can vary depending on the provider and the version in use.

Preparing the OpenCart hosting environment without changing the domain

In the new hosting account, create the database first, then upload the file backup to the document root of the new site. If you use shared hosting, these tasks are usually performed through the file manager, FTP, and database management screen. On a server with administrative access, the virtual host, PHP runtime, database service, and file ownership settings must also be configured; because these settings can vary according to the panel used by the provider, do not change random system files.

Check the result of the import in the database management screen. If the import completes but the store reports a connection error, first compare the database name, user, password, server address, and table prefix in the OpenCart configuration files with the new information. If a table or character-set error appears during import, do not repeatedly retry the same operation; instead, review the database version, import size limit, and character-set compatibility in the provider’s panel. If the error indicates that a PHP extension is missing, do not change the database settings; have the relevant extension enabled or select a supported PHP version.

Steps for safely verifying the migration

  1. Record the backups and the current state. Note the existing store’s homepage, administration panel, and the status of a test order. Record the dates of the file and database backups so that you can return to the previous server if a problem occurs.
  2. Create the new database and import the backup. Review the import result and any error notifications shown on the database screen in the panel. If the operation succeeds, check that the tables and expected table prefix are present; if the number or names of the tables are incomplete, do not continue moving the files.
  3. Adapt the configuration files to the new environment. Depending on the OpenCart version, check the database connection and absolute path information in the configuration files in the root directory and the administration directory. If the old server address remains, change only the relevant value and keep a copy of the original file. If the new homepage opens but the administration panel does not, examine the administration directory’s configuration and secure connection settings separately.
  4. Test the store using a temporary address or preview method. If the provider offers a preview address, use it; without redirecting the domain, open the homepage, category, product, cart, and administration login. If the page opens but images are missing, check whether the theme and upload directories were moved. If an extension produces a specific PHP error, examine that extension’s version compatibility instead of changing the entire store, and use the safe disable option available in the existing administration tool.
  5. Complete a controlled order flow. Test adding a product, entering an address, making a payment, and creating an order using a method that will not affect real customers. If the order is created, check the order record in the administration panel, the stock change, and the expected behavior of the email settings. If a step fails, compare the application error record created at that moment with the web server log; do not treat older records as evidence of the new error.
  6. Repeat the same test after changing DNS. After directing the domain to the new server, run the same product and order flow again. This time, verify the new error records corresponding to the test time and confirm that the store opens through the new IP address. If the problem continues, reverting the DNS change is a safe rollback option for returning to the previous working state on the existing hosting; do not keep changing the new settings without recording when and why you changed the previous setting.

Connect the symptom to the right evidence

Suppose the homepage opens on the new server, product images are not visible, and the error record shows an access problem involving a specific upload directory. This finding does not show that the database is corrupted; first check whether the relevant directory exists, whether the files were actually moved, and whether the hosting account can read that directory. If necessary, re-upload only the missing files or use the provider’s file ownership tool; do not give all files broad and unsafe permissions.

In another situation, product pages may open while a PHP version or extension error appears during the payment step. In that case, instead of importing the database again, compare the PHP environment supported by the OpenCart version and the payment extension. After selecting a compatible version, run the same payment step again and inspect only the new, time-stamped record. If the error record has not changed, do not assume that the previous correction was effective.

When should you consider a different server environment?

If the files and database work without problems during migration testing but resource limits are reached during heavy catalog operations or administration reports, changing only DNS or a PHP setting will not solve the problem. In that case, measure the store’s concurrent-processing, memory, disk, and backup requirements and consider an environment that provides more administrative access. For example, when reviewing options such as Turkey VDS server plans, verify that the specific service can provide the required PHP, database, and backup setup instead of assuming that it is compatible with your store.

The first safe next step is to verify the existing store’s file and database backups in a separate location, then complete a test order in the new environment before changing DNS. Do not move the domain until this test passes; even afterward, keep the old hosting as a rollback option until you have confirmed that orders are being recorded correctly on the new server and that the records appear normal.


Top