Ask a question:
Loading knowledgebase suggestions...
Back to Top
Duplicator - FAQs
On this page are some common FAQs for the WordPress Duplicator. Also included are brief sets of troubleshooting solutions to get you going.
Wordpress Duplicator ©lifeinthegrid.com
Hide All Answers
Questions for creating the package in your WordPress Administrator
Questions about re-deploying your site
Troubleshooting issues for both the Package and Installer
Additional links and information to help with smoother migrations
Please read and review the
as it has
update notes and security recommendations.
Duplicator is aimed at WordPress Professionals and uses very technical terminology and concepts. Since these topics are outside the scope of this FAQ and our ability to train and educate on, we ask that if you need a deeper explanation not found in the FAQ that you use the button below to connect with a WordPress Professional that can help fix, diagnose, and train on any concept found in this knowledgebase.
Get Professional Help Now!
Hide Package Answers
How does the Duplicator work & will it work with my site?
The plugin will backup all of your selected files and database tables (that you don't filter/exclude). The Duplicator puts all your selected WordPress files and a scripted copy of your database into a single zip file called an archive. This package which consists of the installer.php and archive file which are download-able to a different location where you can re-install your site.
At install time the following actions happen:
Archive: Your archive file including all WordPress files are extracted along with the database script.
Database: Your database is then re-created based on the new configuration setup
Database: Every table in your database is scrubbed for a new URL update and server file path
Database: Every cell is validated for PHP serlized and Base64 set strings
Files: The wp-config.php is scrubbed for updates to WP defined variables
Files: The .htaccess file is reset for the new location
Will the Duplicator work with all my themes and plugins?
In 99% of most cases it will work with your theme and your plugins. However there can be issues at install type where data was not able to port correctly. This is where you will need to read the final report on step 3 of the installer and validate the options that the plugin could not update. If you run into any errors or warnings please read the section directly below.
Does this plugin work with Multi-Site or MU?
The plugin is currently experimental with MU (Multi-Site). You are definitely welcome to try the plug-in with your MU site and provide feedback for the necessary tweaks/updates you made in order to finalize your install.
Is my server compatible with the Duplicator?
Before you create a new package a requirements check will show you the status of your system. The following are system checks that are performed before package creation can take place.
Paths that are listed in this section should have permissions of 755 for directories and 644 for files. On some hosts the permission set requires 777. Setting items to 777 is a security issue and should only be set temporarily. Please avoid any hosting company that requires this kind of setup. See the
Duplicator Approved Hosts
page for a list of approved hosting providers.
Also be sure to check the Owner/Group settings and validate they are correct and match other successful directories/files that are accessible. For more details contact your host or visit their help pages for more information on how they implement permissions and group settings.
3. Troubleshoot - Permission and System Issues
SYS-101: Reserved Files
If this check fails then a reserved file was found in the WordPress root directory. The following are reserved file names installer.php, installer-data.sql and installer-log.txt. In order to archive your data correctly please remove any of these files from your WordPress root directory. Then try creating your package again.
SYS-102: Zip Archive
The ZipArchive extension for PHP is required for compression. Please contact your hosting provider if you're on a hosted server.
Duplicator says that the Zip archive extension fails, however my host says it's enabled. What should I do?
The Duplicator uses the following PHP
and if its not found then processing can't be performed. Be sure your host is looking at the same thing as there are several versions of doing Zip compression in PHP. Have your host visit the link above for instructions on how to enable the Zip Archive class. If this is something they won't perform on your behalf here is a
list of excellent hosting provider
that will enable or already have it enabled for you. Some users have seen successful ZipArchive detection when they asked their host to update to PHP 5.3 or better.
4. Resources - Working with PHP ZipArchive
SYS-103: Safe Mode
Safe Mode needs to be disabled in order for the Duplicator to operate correctly. Please set safe_mode = Off in you php.ini file. If you're on a hosted server and don't have access to the php.ini file then you will need to request this setting be updated.
SYS-104: MySQL Support
In order to complete an install the mysqli extension for PHP is required. If you are on a hosted server please contact your host and request that mysqli extension be enabled. For more information visit: http://php.net/manual/en/mysqli.installation.php
SYS-105: PHP Support
The Duplicator requires PHP version 5.2.17+ or higher. Note that 5.2.9 or 5.2.8 is not higher than .17... Please contact your host and have them upgrade to a stable secure version.
SYS-106: Web Server
The Duplicator currently works with these web servers: Apache, LiteSpeed, Nginx, Lighttpd, IIS, WebServerX. However the best success we have seen with Apache
How do I exclude tables and folders from being archived?
On the setup step of creating a package find the file filters and database filters. For file filters enter the
of the directory(s) you want to exclude. You can separate additional exclusion paths with a semicolon. This process can be useful if you have large files such as images or videos that you don't want to package. However be careful which folders you exclude. Excluding the wrong folder or database table that has core WordPress or theme files will not allow your site to work at install time.
Adding to many filters slows down the package creation process. The more filters you add the more validation checks need to be made. The inverse is also true of larger files. Larger files can take a long time to archive. So the best solution is to only create filters that you truly need. If you don't have any .mov filesin your application then don't add that filter. However if you have .mp3 files that are large then that filter should be added.
Why is the user interface is not working correctly?
This is usually caused by a plugin or your active theme. To find out quickly if its either of them:
Disable all plugins temporarily except Duplicator and see if the error persists
Change your theme temporarily and see if the issue persists
you may be able to pin-point the issue that way. You can also install a
What if I get an error while creating a package?
Open the log file associated with the package you tried to create and look for these items:
Look for for warnings or errors, then check the Troubleshooting section below for the related issue
Look for the text 'DONE PROCESSING' at the very end of the log file this indicates the package processed fully. If you do not see this text then you are probably experiencing a timeout issue. Please see the 'Timeout Issues' in the Troubleshoot section below
Turn off all cache plugins:
Many of the popular cache plugins have been known to create issues when you go to create a package and re-install your system. It is highly recommended that you turn off all caching plugins while creating your package and add the cache directory to the directory filter list.
Why does the scanner/build process show zero files?
If you run a scan or try to build a package and the results show up with no files being found. In your server could be configured with "server separation". You will need to contact your hosting provider for more details however this can be an issue on some systems.
Possible options in Domain Configuration window are:
Forward to subfolder without service separation
Forward to subfolder with service separation
Forward to IP/Host/URL
Switching temporarily to #2 will allow the Duplicator to run without issues for both the package and installer.
Hide Installer Answers
How do I launch the installer & what should I expect?
Make sure your server has PHP, Apache (or a simular web server) and MySQL.
Your site should
already have WordPress installed.
the archive file and the installer.php files to an
folder on your web server. Make sure the directory they are copied to have the correct permission. Then open a web browser and browse to the installer.php file.
Connect to your Database using the 'Test Connection' button. If your on a host then you will need to manually create the database using a tool like phpMyAdmin.
Fill-in the installer fields and proceed with the installation.
Restarting the install process:
1. Remove all files and directories from where you just installed your site (except the installer and package file).
2. Hit your web browsers back button or browse to the installer.php file again.
3. Run the installer again.
How long should I wait for the installer to run?
The installation process may take a few minutes (never hours) depending on the speed of your system and the size of your content. Be patient and wait for the process to complete. Once the installation starts an install-log.txt file is created in the same directory as the installer.php and package file. You can open up this file anytime during the install and see the progress of the install. You will have torefresh the page to see any process updates to the log file.
Why do I get plain/text or a download prompt when browsing to the installer?
When you open a web browser and browse to the installer.php file such as http://yourserver/installer.php you are asking the web server to process the PHP file. If you see a bunch of text and code then the web server you placed the installer file on is not setup correctly or not setup at all. In order to run WordPress you will need a web server such as Apache, PHP and a database like MySQL. For instruction on how to setup your own WordPress server see
. There may be others issues you run into. Below are various suggestions/fixes for this possible scenarios.
If you just seeing plain text/code on the screen the simple fix most of the time is to open the httpd.conf or .htaccess file and add the following lines:
AddType application/x-httpd-php .php .htm .html
AddHandler x-httpd-php .php .htm .html
It will be different on your setup so google whatever platform your using XAMPP/MAMP/SUSE etc. along with the term AddType php and there should be some posts that explain exactly how to set it up.
If the installer has other issues such as not being able to submit data then make sure you are not forcing specific php handlers. Some hosts will have a line in .htaccess file such as:
AddHandler application/x-httpd-php5s .php
Comment out this line by adding a # sign in front.
If your seeing issues such as prompt to download the installer file then you may have a .htaccess file that is corrupt or not configured to work on/at the new location it was copied to. Sometimes removing your original .htaccess file that got packaged inside the package.zip file can resolve issues at install time. If you find your-self experiencing strange issues at install time try removing the .htaccess file that is in the same directory as the installer all together.
If you see an error such as:
Parse error: syntax error, unexpected $end, expecting T_VARIABLE or T_DOLLAR_OPEN_CURLY_BRACES or T_CURLY_OPEN in ... installer.php on line 1300
Then the encoding on your file is not being accepted by your web server correctly. The fix for this is to open a program like
and play around with the encoding from Ansi an UTF-8 try to convert from one format to the other and then save the file and then re-upload the installer file to the server to see which version works.
Additional Search Links:
How do I do a 'Manual Extraction'?
In order to
a package your server must have
. To install a package your server
need this feature. Follow these steps to manually extract your package:
1. Place the installer.php & package.zip in an
directory on your web server
2. Open a file browser or cpanel file browser and navigate to the package.zip file
3. Extract the contents directly into the
directory as the package.zip file
The manual extraction process must place the wp-config.php in the same directory as the installer.php file. Moving the wp-config.php to the same location as the installer will not resolve this issue, it must be extracted in context with all the other files and directories.
4. Open a
browser and browse to the installer.php
5. Check the box 'Manual Package Extraction' under 'Advanced Options' and click install
I'm having some issues on my MAC what might be the problem?
In MAC systems you can automatically unzip files when download is complete on some browsers. This will cause issues with the Duplicator because the installer looks for a zipped up package file. To turn this feature off in browsers like Safari please follow these steps: Go to: Preferences > General > Open Safe files after downloading -- leave this box unchecked.
Why do I get 404 errors after installing?
This is most likely being caused by a redirect somewhere on your server. Here are several places a redirect can be triggered from:
- A .htaccess file, wp-config.php or functions.php
- A redirect plugin you may have installed
- Some cpanels allow for redirects.
for fixing perma links.
- See "View Install Report" on the final step of the installer for clues to items that may have not been processed completely
- Try to remove your .htaccess file and start with a fresh one
There are a ton of tools online to test URL redirects, just
Google for it
. If your testing on a localhost you can find tools online that will help. Here is a simple
that will do the trick.
A MAC/MAMP solution
1) open terminal
2) type defaults write com.apple.Finder AppleShowAllFiles YES
3) open the folder where the site is
4) look for a hidden htaccess file and delete it
5) check your site
3. Troubleshoot - Common issues with WAMP, XAMPP, MAMP and CPanel
What is my WordPress admin password?
- Your password will be the same as the site you duplicated.
- In step 2 under advanced options of the installer you can create a new Admin account
- If you need to reset the password here are
The WordPress installer keeps showing up after I install.
This behavior should NOT happen and is usually caused by either corrupted database or data that was not transferred properly. Here are a few things you can perform if you see this issue
- Run a
repair and optimize
on your database.
- Try to run the installer again (see question above)
- Check your wp_options table and make sure the data is correct
Why are some of my plugins/images/links not updating?
With over 50,000+ plugins available for Wordpress it is impossible to know what they all do and how they store data. Some minor modification may need to be made after your done with installation. If your using plugins like 'All in One SEO' or other plugins that internally update your site title then you will need to manually update those types of plugins.
Pay Attention to your install URL
On step two of the installer you are asked to enter a new URL. This step is very important as it will define the replace logic used to update all of your links. The old URL is replaced with the new URL. It is an
. If you find that a link did not get updated correctly, you will need to validate that the link was exactly the same as the old URL found in step two of the installer, if for any reason it was different then you will need to manually update that data for that link.
After you are done installing and a plugin or theme does not seem to be working correctly its best to try and resave that plugins settings. Also pay close attention to the report in step 3 of the installer as it will help show you error or warnings in data that may have issues.
Check out the write up on
Check to see that you don't have hot-linking enabled. For cpanel users here is a
Check your wp-config.php to make sure you don't have global parameters set which point to an old url
Validate you don't have any plugins installed that mess with how your URLs work.
Check the install report on step 3 of the installer and make sure no errors or warnings were found attention to the report in step 3 of the installer as it will help show you error or warnings in data that may have issues.
If a theme or plugin is missing data you will be able to resolve your issue
by contacting the theme author or plugin author. Explain to them that you just migrated a website and the settings to their theme or plugin is not working correctly. They will be able to much better assist you with the issue and help you isolate how to fix their theme or plugin than we can.
Why are some of the files from the package.zip not extracting correctly?
This behavior should NOT happen and is usually caused by either a corrupted zip file or a zip file that was created with filenames that are too long. Below is a list of items/plugins that create file names that are too long.
Fix: Flush the cache in the plugin settings or remove all files from cache directory
WP-Super Cache Plugin
W3 Total Cache Plugin
Fix 1: Exclude the directory with the "Exclusion Filter" in the options dialog.
Fix 2: Flush the cache in the plugin settings or remove all files from cache directory.
Fix 3: Temporarily remove and delete the plugin then create a new package set from the Duplicator
To validate files are not correctly extracting. Download the package to your desktop and try to manually extract with a desktop program like winrar, winzip or any other zip extracting software. During extraction you will receive and error message.
Hide Troubleshoot Answers
Log files & System Access
How do I read the Package Log?
The Package log shows every step of the package creation process. Follow these steps to see a package log file:
1. In the Packages Screen under the details column click the [View #] link, then click the 'View Log' button
2. You can also view all of your logs by going to the Tools menu and clicking on the logging tab
If you're working with support on a problem copy the log results into the help ticket message. Be sure to copy the log for the package you had an error with by clicking on the 'View Log' button associated with each package set. Please do not post any of the log data on forums like WordPress.org as it contains sensitive data.
How do I read the Installer Log?
The Installer log (installer-log.txt) shows every step of the installation process. Follow these steps to properly see the log:
1. On the installer.php file fill in the required inputs and click the install button and complete the install process.
2. Click on the installer-log.txt link at the top of the final screen in the installer
3. This file can also be found in the same directory as the installer.php and package.zip files after attempting an install
If you're working with support on a problem copy the log results into the help ticket message. Please do not post any of the log data on forums like WordPress.org as it contains sensitive data.
How do I share system access?
In order to help diagnose your issue quickly we will need access to your servers. Locate the problem area below that you're having and fill in the following bracketed fields and copy into your help ticket.
Please test ALL usernames and passwords before sending. Make sure you can login to the specific system yourself. We ask that you please
and make sure they work so thatyou don't have to resend.
If you can’t create a temporary cpanel account then temporarily change the password while we diagnose your system. You can easily change your password back once we are complete.
1. Problems Creating Package
Copy & Paste Into Your Ticket
I'm having issues with creating a package:
[temporary admin account]
[temporary admin password]
Server FTP or Cpanel
[temporary ftp/cpanel account]
[temporary ftp/cpanel password]
2. Problems Installing a Package
Copy & Paste Into Your Ticket
I'm having issues installing a package:
Server FTP or Cpanel
[temporary ftp/cpanel account]
[temporary ftp/cpanel password]
New Database Settings
[Normally this is localhost, however it can be different on your host]
[The database user that has access to create tables]
[The database user password]
[The database name]
Yes I followed the <Install Preparations> below
Please make sure these items are
completed before sending
The installer.php and package.zip file are in a web browsable directory with no other files or folders. If you have other files in the directory then the extraction process WILL overwrite those files/folders. Therefore we won’t diagnose your system unless the directory only contains the two files.
Be sure you can connect to the database, by clicking the ‘Test Connection’ button, if you're unable to connect to the database see
The database settings that you give is what we will use to populate the database with. If this database already contains important information then it WILL beoverwritten with the new package data. Please double check the credentials you send us as we will not be responsible for lost data. We also
that you have a backup of all databases and important files ahead of time.
What things can I do to validate my system is compatible with the Duplicator?
Check Disk Space
If the package creation process stops and the error log does not provide additional details, then check that enough disk space is allocated to back up your site. On most hosted servers check your cpanel for disk allocation.
Disable Cache Plugins
Be sure you have disabled all cache plug-ins. This will ensure that you don't archive any cached content. It is also recommended to exclude any cache folders, which can be set in the "Directory Filter" input box found on the options dialog package tab.
Clear Browser Cache
Be sure to clear out your browser cache and refresh the plug-in page. You can clear your browser's cache by hitting control + F5. Sometimes you will manually need to go into the browsers settings and clear it manually.
Review logs by clicking on the 'Show Create Log' button in the toolbar. When submitting a ticket please always include the log file.
Contact Hosting Provider
Many issues that arise while using the plugin tend to be related to how a server is configured. It's impossible to know all the various configurations a system might be in. Many issues with the plugin reside around permission issues or disk quotas. Please also work with you hosting provider if you run into issues, as they will be able to more promptly help you address your issues.
Common issues with WAMP, XAMPP, MAMP and CPanel
Basic support does not include help with setting/configuring a web server or development environment. Because these types of issues can consume huge amounts of time and don't directly help the development effort of the plugin we unfortunately cannot help with these issues.
While we would love to help you get your system up and running, we physically just don't have the bandwidth with all of the requests for help we get regarding these issues. We have tried our best to put together some resources that will get you started...
Below are some very helpful links that will help you get going with custom development environments. You can also hire very affordable technical staff from the
page. These IT prs can help you isolate and pin-point your issues very quickly and very affordable.
- View the
- Ask a question on the
- Review this WordPress item
Install Basic XAMPP
- Watch this video
localhost your wordpress
- View the
- Ask a question on the
- View the
- Ask a question on the
Paal is a contributor to the WordPress Duplicator and a very experienced MAC user.
- View the
- Ask a question on the
- If all else fails consider trying to Google for the issue your having.
I got an "Internal Server 500" message what should I do?
500 errors are generic in nature and difficult to isolate. Typically these errors are related to file permissions, ownership rights or a server that is not configured correctly. Here are a couple of actions you can take:
Call Your Host
Let them know you are getting “Internal Server Errors”. A
good hosting provider
will help you diagnose the problem or at least point you in the right direction.
Check Duplicator Logs:
Both the Package and Installer phases have logs specific to each process.
Check Server Logs:
Open your control panel (cpanel) at your hosting providers website. Look for a link to something like "Error Logs" and open it. Be sure to match up the correct time stamp in the error log with the time for which you were attempting to use the Duplicator. Sometimes the error messages can be vague so you might have to Google for the actual error message and see what the work around was for that particular message. Remember there can be many different possibilities so look for a question that closely represents yours. Here is a great article for
how to read your server logs.
Most of the time these issues will need to be worked-out by your hosting provider. Make sure they are helping you to pin-point the issue. Giving the support staff access to your system to reproduce the problem goes a long way. You are paying them for a service so don’t let them give you the run-around. If one technician can't help you then ask to speak to another.
If your host can't help give you a work-around or they give you a canned response such as "We don't support 3rd Party Plugins" and you need immediate attention then we suggest to check-out some very affordable highly technical freelances from the
.They should be able to help you get your problems solved very quickly.
Why do I get a blank screen on my site?
With millions of possible configurations it's impossible for the Duplicator to catch them all during a migration. If you see a blank screen it can be related to some of the issues below. Also it's important to isolate the area that you're seeing the blank screen and do a bit of research on the web to see what might be causing the issue.
For example if your wp-admin (WordPress administrator) comes up blank then it will be best to do a quick Google of the issue. Searching for something like
“wp-admin comes up blank”
will help point you in the right direction and get you an answer much quicker.
Consider trying these options or see the info in green below:
UPDATE: Be sure your using the latest version of the plugin and WordPress.
WP TROUBLESHOOT: Check the
WordPress Troublshoot Codex
CHECK THEME: Change to a new theme really quick to make sure the theme and plugin are not having a conflict. This usually isn't the case but it is a good sanity check.
VALIDATE PLUGINS: Try to disable all other plugins temporarily and see if the issue persists. If it gets fixed then you will have to manually enable each plugin till you see where the plugin conflict may be occurring.
CHECK BROWSER: Open another web browser and see if the white screen still shows. If not then it may be a browser cache issue. You can usually fix this by holding down ctrl+F5 or manually deleting your browser cache.
LOGIN/LOGOUT: Try to login or out of your admin to check and see if your session maybe got messed up.
CACHE PLUGINS: Clear all your cache plugins. Sometimes they can cause issues.
PERMISSIONS: Check the permissions on plugins files. Directories should be 755 and files should be 644. Also validate the group/owner is the same as other plugins that work.
LOGS: Check the
php error logs
and see if there are any clues there and then google those...
Wordpress JQuery Issues
: This actually is an isolated issue on some wordpress installs and it deals with how load-scripts.php (a core wordpress file) is working. If you check your browsers debug window it will show if this is the issue. In Chrome you can isolate this issue by doing the following:
1. Right Click anywhere in your wp-admin when the Duplicator dashboard is loaded. Go down to 'inspect element' this will open Chromes developer tools. Click on the 'Console' button at the very top.
2. Now refresh the blank duplicator page, and you will see a 404 error on the load-scripts.php page. If you see the 404 error then it means your wordpress update was effected. If so there are several causes for the error.
Here are some workarounds that people have told me works:
[Work Around 1]
[Work Around 2]
[Work Around 3]
[Work Around 4]
Others have just updated following these instructions: Try re-uploading all files & folders - except the wp-content folder - from a fresh download of WordPress. Make sure that you delete the old copies of files & folder before uploading the new ones.
Also if you google "load-scripts.php 3.5 'jQuery is not defined'" then you will find several solutions.
What should I do when I see a warning in the log about " disk quota issues"?
- Check your disk quota on some of these popular systems
If your not sure about your Disk Quota contact your host. Typically they will give you a canned response like you have "unlimited space" which is typically just marketing chatter used to get people to purchase accounts and get off the phone with you quickly. The truth is a quota is placed on every account according the the Terms and Conditions of the account.
Many cPanel accounts give you an unlimited number (again marketing chatter) of domains you can setup. With each domain they create a new directory and cPanel silo for that domain which usually has a quota on how much space you can allocate to that directory see the link above.
Most web hosts control panels will have a progress bar on the main dashboard that shows how much space you have for the specified domain. If your not using a cPanel setup ask your host where you can find out your disk quota, don't settle for your account is unlimited response
So in short try to get a real answer from your host and if they still give you a canned response then try to upload a file which should be 5 times the size of your 'Pre-Scanned' site size. So if the pre-scan shows 50MB then try to upload a file that 250MB add see if it allows the file to upload. If it does not then you definitely have a disk quota issue.
How can I fix international characters issues?
Support for international character sets is currently in an experimental state. The process of converting/retaining a character set when moving across different operating systems or even different servers has many complexities. Many of the issues that arise when working with international character sets actually deal with the differences in your database set up when moving to a new database. Below are a few threads of some workarounds for international character sets.
[WordPress Forum 1]
[WordPress Forum 2]
What can I try for Timeout Issues?
Timeouts are spotted by Duplicator log files (package or installer) that do not finish. All log files that finish completely with have text saying 'DONE PROCESSING' or 'COMPLETE'. If your log file just suddenly stops and does not complete; then in most cases your hosting provider or server has a restriction for how long a process can run. If you need a list of approved hosting providers please check out the Duplicator approved hosting
Timeouts are controlled at three different layers:
The PHP processor will time your script and then kill the connection after a specific time (normally 30 seconds). This value can be changed if your hosting provider allows it. The Duplicator will try to adjust this value if it has privileges to do so, if not then you will need to
work with your host
to resolve the issue.
The quickest way to resolve a possible PHP timeout on your server is to contact your hosting provider and see if they offer a way for the PHP processes to run longer than the default timeout of 30-120 seconds. Many hosts offer a way to make this happen and you will need to consult their documentation. On some hosts you can place the following inside a .htaccess file in your web sites root folder or inside the plugins/duplicator folder.
php_value max_execution_time 0
0 means no limit
Because every hosting provider is different, you
contact your hosting provider to find out how to adjust this value properly on their systems. Please do not submit a request for help on the forums for all the different solutions you have tried. You
get the settings directly from your hosting provider. Simply guessing and trying different options will not always work. If they do not provide you with a solution then will not be able to fix timeout issues on that server and we suggest you upgrade to a
system which gives you full control of your server and its setup.
Also note that if your hosting provider tells you that there is no PHP timeout limits set or they have adjusted it to a very high number, yet you continue to experience timeout issues (your log file continues to still get cut off) then the hosting provider may have timeouts set at the web server level. Please see the section Web Server below...
The web server can also place a timer on your script and then kill the connection based on a specific time. This value can only be changed by your hosting provider or server administrator. Please contact your host to find out if this is true for their setup. Please do not email or submit a request for this issue as there is nothing we can do to fix the restriction.
But I need help with my personal server...
While we would love to help you, it just consumes way too much time for yourself and us to try and transfer so much knowledge and walk through all the possible scenarios that go with configurating a web server. If you manage your own server then you will need to do the necessary research to find out exactly how your server environment should be set up. With thousands of different permutations it's much too difficult to try and debug/diagnose your server set up over a forum/e-mail/ticket system and those requests are outside the scope of this free plugin and free basic service.
If you need help setting this up correctly on your own system than we suggest you hire a
professional server administrator
to help. If your working on a
managed VPS server
then the support team for that host will be able to help you get any of these issues setup quickly. In most cases they will do it for you...
If you are trying to create a package and the package log suddenly stops on a table and you see something like:
02:55:06 done: wp_posts
02:55:06 start: wp_stats (1435897)
followed by no additional logging, then the SQL generation has failed.
There are few things you can try:
repair and optimize
on the table, from a tool like phpmyadmin.
If your hosting provider supports 'mysqldump'; then this option will improve the overall package creation time and installer time for the database. Under the settings menu look for the 'Database Build' option and check the box that says 'Use mysqldump' this option works great for larger databases.
Most tables that we see fail are logging and statistical data with records into the millions. We strongly recommend to use free tools like Google Analytics vs. a stats plugin. Custom plugins tend to slow your site down with additional requests and don't offer the same reporting capabilities of tools like Analytics which has almost no performance impact on your site.
Temporarily backup the table and remove it for the process to continue. Then manually re-import the table.
Work with your host to increase the timeout or script processing for Apache, PHP and MySQL. We highly recommend these
which will allow your scripts to finish running in most cases.
Also be aware that you can also run out of disk space on your server, which can also show itself as a timeout issue.
If the log indicates that you made it past the database script process then you may experience timeouts with backing up all your files. Below are a few items you try to if you run into issues with backing up all your files:
Try to exclude large files such as movies, large images or other backup files (like .zips or .tar files) from the file filters section
Exclude your wp-content/uploads folder by adding it to the directory filters option. Then after the install is complete at the new location you can manually copy/FTP those files back over.
If your running into timeout issues on the installer.php file then consider "Manual Extraction" and 'mysqldump' modes. See the
How do I do a Manual Extraction?
Alternative Backup Solutions to the Duplicator?
What should I do when I see a warning in the log about " disk quota issues"?
What if I get a "Allowed memory exhausted" message?
This issue will occur when your server or hosting provider limits PHPs ability to use additional memory. You can try the editing the .htaccess, php.ini or wp-config.php files. If none of these options work then you will need to contact your hosting provider and see if they provide another option.
Edit your .htaccess file in your WordPress root
php_value memory_limit 2000M
Edit the php.ini setting to this:
memory_limit = 2000MB
Edit your wp-config.php file and add this:
This option would apply only to creating a package
For the first two options on some system the web server will have to be restarted. Please contact your host for details.
Permission & System Issues
I get an error/warning about permissions what should I do?
Because there are so many different permutations on how a server can be set up we don't teach end users how permissions work. It can be difficult to understand how a particular hosting company or personal web server might need to be configured. The best way to alleviate permission issues is to have a general grasp of how permissions work. Check out
for a full rundown on how permissions can be set up in WordPress and then consult your hosting company or personal web servers documentation.
set your permissions to 777 on the areas where you are seeing errors to see if you can get past the issue.
- Check the owner/group (
) of the PHP process your system runs under to make sure it has the correct permissions.
Please contact your hosting provider more details on this issue if your not familiar with the concepts.
- Some hosts don't let you change permissions of the root directory consider trying /public_html
Check with your host to find out where you can update the permissions for PHP to read/write files
There is no additional code we can add or change to get permission to work in your environment should you receive a permission error. The plugin uses standard PHP calls for accessing the file system. If the PHP process that runs under your web server is unable to access a file or folder it’s because PHP does not have enough privileges. You will need to modify your permission setting to get the plugin to work. Because there are so many different possible configurations, web-servers and operating systems you will need to consult the documentation of your hosting provider or your personal web server you’re using. One of the most helpful places to check is the forums for these particular services and software as permission issues is what they are used to dealing with.
Popular Hosting Docs:
User Guide Videos: Windows to Linux & Permission Modifications
Working with PHP ZipArchive
For creating Packages the Duplicator
the ZipArchive class to be installed and working. For installing a package it is not required. Below are instructions for getting the ZipArchive working in your environment if it is not already setup.
You can easily validate the
installation of ZipArchive
by checking with
. These settings can be viewed by going to Duplicator > Settings > Diagnostics > PHPinfo. Within the phpinfo output search for
within the results of this command look for
. If that is not present then talk with your hosting provider.
ON HOSTED SERVERS
Just contact your hosting provider and tell them you want PHP with Zip support so that the "ZipArchive Class" will work. If they don't know what your talking about or will not enable it then I would suggest getting a new hosting provider. This is a very common feature and is available on almost all shared hosting environments. Please view the following link for a
list of approved hosting companies
that we personally recommend for working with the Duplicator.
ON YOUR COMPUTER
On your own computer you will to to make sure the Zip extensions are enabled for PHP. Check your php.ini file for the following:
On Windows: extension=php_zip.dll
On MAC and Linux: extension=zip.so
PC (XAMPP, WampServer, ect...) resources:
MAC (MAMP) resources:
1. Package - SYS-102: Zip Archive
2. Installer - How do I do a Manual Extraction?
What is an Open Base Dir error or "open_basedir restriction in effect"?
This problem happens mostly on shared networks. In short it limits file access for PHP scripts to a designated directory. Your hosting provider will have to disable ‘open_basedir’ on your server or for you directory.
In this case either of the following solutions would work.
1. The host should disable the restriction
2. Or the host can add the ‘concerned folder path’ to the list of allowed folders.
The package process may still work if this check fails, however because this setting tends to introduce other possible side effects its desired to have it disabled.
Here are some additional resources for this topic:
A scanner says that a security issue/malware/threat was detected is this valid?
Just a warning by a Malware scanner will not provide you with the details needed to pin-point a possible threat. The scanner should report why it thinks the file is a risk and what it thinks the issue might be. Be sure your scanner does more than just say XYZ file is a threat. It needs to give details and say exactly what lines of code are an issue and why.
The base install of the Duplicator is known to be safe and continually scanned by third party security companies. You can be assured that the original install of the plugin is safe and if any items are reported that a patch will be applied promptly. However because WordPress systems can and do become compromised it is
responsibly to evaluate any type of possible compromise to your system.
While we would love to help out in these issues, it is in ours and your best interest to hire a third party to double check and evaluate your system should you be unable to determine if the there is a possible threat. Because this is a free basic help system we believe you should have someone take the time to do a deeper analysis of your system should you be unable to identify the issues yourself. You can easily grab an
to check the files in question or get a deeper answer from the scanner and possibly some help from your hosting provider.
Please do not post code snippets to the fourms, the free ticket system or email us the issue. Simply looking at a single file is not a good anylsis of your system. Other items need to be evaluated such as file permissions, owners and access write times. Because this process can take time andrequires detail, you will need to hire a professional to evaluate your system if your unable to evaluate it yourself.
I can't connect to my Database what should I do?
Quick Check List
The database or database user has not been created
The database user has not been assigned to the database
The database user does not have the correct permission levels
The password does not match the user
Contact your hosting provider for the exact required parameters
Double check your username and password...then triple check them. This is one people often overlook, or check so quickly they don't even notice their mistake. Not only do you need to check that they are correct, you should make sure they have the correct permissions for what your script requires. For example, a read only user can't add data to the database... they would also need write privileges.
If your error message contains the text "Access Denied" this means you don't have your Database users setup correctly. Please review
for a detailed rundown on how to setup your database user accounts.
If your error message contains something such as
"Can't connect to local MySQL server through socket '/var/lib/mysql/mysql.sock' (2)"
then it is most likely that you don't have the hostname correct. Please see
this forum thread
for a run-down of one users experience.
If your on a hosted server you will need to contact your hosting provider to make sure your using the
they provide. Many hosting providers have different ways for how to connect to their databases. You will need to validate what rules they use on their servers. For the fastest response just connect with them via a chat channel or give them a call and ask them.
Localhost will work in most cases however it does not always work which is why you will need to check with your hosting provider for the
. Often it's something like mysql.yourname.com or mysql.hostingcompanyname.com. Sometimes it may even have a port number like "mysql.hostingcompanyname.com:1400" If you ask your hosting provider they can point you in the right direction. Please see
for other various combinations.
Here are the help files to some of the major providers:
The answers above are not what I'm looking for any other ideas?
Consider searching through the MySQL forums or doing a general search at wordpress.org. If your not used to working with or around databases we suggest you hire a
to help you quickly resolve your issue.
I can't connect to my Database what should I do?
What if the log stops during the table creation process?
Hide Resource Answers
How can I help contribute to the plugin?
Check out our
as it has several things you can do to help out!
Every time a release is pushed, it's beneficial to have additional testers. If you would like to help test the plug-in before it's pushed the global WordPress community. Submit a
and well get you added to the pre-launch list.
Because the plug-in is quite sophisticated we would like a little bit of background to know where you stand as a programmer. Send us a quick profile page or your resume and we'll get back with you as soon as possible. Please note that we take a lot of pride in making a solid product, and before giving anyone access to the source control we like to get a feel of whether you're a good fitfor the Duplicator team.
Are there other alternative to the Duplicator?
If your unable to get the Duplicator to work on your current server we
! We are continually working to get the plugin to support morehosts and environments every month. With thousands of different server setups it takes time to get the plugin to work everywhere. Because we know its important for you to succeed with your migration and back-up solutions we have listed some other options that might help in your particular situation.
How can I get additional help or resources?
While we would love to help you work through any struggles your having, we have physically reached a point were we have to keep our basic help at a bare minimum. With the popularity of the plugin it just consumes way too much time for yourself and us to try and transfer knowledge and walk through all the thousands of possible scenarios that go with configurating and using the plugin in a complex system of databases, web servers and post processing languages like PHP.
Because this is a free plugin with free basic support we have to out-source a good portion of help requests. However we have also tried our very best to put together
to help you through the process. We are also continually working on and improving the plugin itself and all of our
so please check them all out. If your still at a point where you need some extra guidance or you need a programmer to validate some data for you please use the button below to grab some help. Most of the rates for this help is very affordable and can save you hours of searching and testing. Even as an experienced IT/WordPress professional it's a good idea to get a second look from someone else, I use these same services myself and they have saved me enormous amounts of time.
Get Help & Resources!
Quick Start Guide
Help Desk Software
- brought to you by
Help Desk Software