Duplicator Knowledgebase
Quick-Start |
User-Guide |
FAQs |
Changelog
|
---|
FAQ Contents | |
---|---|
Management | Sales, licensing and plugin setup |
Create Backup | Package creation in the WordPress admin |
Install Backup | Install/Importing your package to a new location |
Troubleshoot | General troubleshooting issues |
Host Specific | Host specific instructions |
Resources | Learning about and using Duplicator |
cd /public_html/mywordpresssite/
wp plugin install duplicator --activate
cd /public_html/mywordpresssite/
wp plugin install http://[URL_YOUR_COMPUTER_CAN_REACH]/duplicator-pro-4-5-0.zip --activate
MultiSite wp plugin install http://[URL_YOUR_COMPUTER_CAN_REACH]/duplicator-pro-4-5-0.zip --activate-network
sudo -u www-data wp plugin activate http://[URL_YOUR_COMPUTER_CAN_REACH]/duplicator-pro-4-5-0.zip
define('DISALLOW_FILE_EDIT', true);
define('DISALLOW_FILE_MODS', true);
Also See:
» Terms and Conditions
» How do license upgrades and renewals work?
Current Product | Upgrade Price |
---|---|
Personal ❯ Freelancer | $40 |
Personal ❯ Business | $160 |
Personal ❯ Gold | $461 |
Freelancer ❯ Business | $120 |
Freelancer ❯ Gold | $421 |
Business ❯ Gold | $301 |
Also see:
What can I try for timeout Issues?
How do I run the installer in Database Only Mode?
What if I see warnings or errors during the 'Scan Process'?
Recommended hosting providers for Duplicator?
sudo apt-get install php7.0-zip
To see additional PHP 7 libraries that are available, run:
sudo apt-cache search php7.0-*
Also see: How do I do a 'Manual Extraction' or run installer without Zip enabled?
$admin_role = get_role( 'administrator' );
$admin_role->add_cap( 'export', true );
Also see:
WordPress Form: Menu Tools - Export Missing
WordPress Codex: Roles and Capabilities
Also see:
What can I do for issues with migrating a large site?
What can I try for 502/503/504 Gateway issues during the scan/build?
Recommended hosting providers for Duplicator?
<IfModule mod_timeout.c>
<Files ~ ".php">
SetEnvIf Request_URI "admin-ajax" DynamicTimeout=240
</Files>
</IfModule>
<IfModule Litespeed>
RewriteEngine On
RewriteRule .* - [E=noabort:1, E=noconntimeout:1]
</IfModule>
Also see:
What can I try for 502/503/504 Gateway issues during the install?
Recommended hosting providers for Duplicator?
To resolve this issue please do the following:
Also see:
What can I do for issues with migrating a large site?
Recommended hosting providers for Duplicator?
Also see:
What can I do for issues with migrating a large site?
Recommended hosting providers for Duplicator?
If you can't determine which plugin is causing the problem, add the cache directory to the file filter:
Also see: How do "Shell Zip", "ZipArchive" and "DupArchive" engines differ?
AddType application/octet-stream .zip .log .sql .dafThis tells the web server to treat the extensions files as download-able. Other web servers will have similar configurations. Please check with your server administrator for your proper setup. If you can not download the installer.php file then you will need to follow the directions below and get the file off of the server via FTP.
There are several common reasons for a slow build:
Unnecessarily Files: Look for large file warnings during the scan report step. Go through the list and determine if you need to backup that file. Go back to the package creation screen and add the full path of any large unnecessary files to the ignored file list. Backups created by other backup plugins should not be backed up. Also look for larger log files and data that is not needed for a proper restore.
System Zip: The zip routine built into the operating system is much faster in most cases then trying to use PHP. Go to the Settings/General page. Ensure "Archive Engine" is set to "Shell Exec" instead of "ZipArchive".
Slow Server: If you've tried the options above but your builds are still slow, chances are if you're on a budget host then the server is currently overloaded. Please contact your host's support and ask to move servers or have the slowdown investigated. If you have access to your on server or VPS consider increasing the PHP memory_limit.
Also see:
What can I do for issues with migrating a large site?
Recommended hosting providers for Duplicator?
Dear YOUR_HOST,Once you have received the path from the host, place the installer and archive in the path they have provided. Next open up a web browser and browse out to the installer file such as http://your_domain_name.com/installer.php
I would like to install a WordPress site on my domain "http://YOUR_DOMAIN_NAME_HERE.com", however I'm not 100% sure where this domain name maps to on the servers file structure. Could you please point me to the full path for where this domain name points to on the server?
Thanks
Also See:
Video: How to extract zip file on cPanel
Status | Source | Notes |
---|---|---|
Generic Host | Most hosts that allow .zip or .daf files to be downloaded directly should work. If issues arise with a specific host try the download directly from your browser and if issues arise then contact your host. | |
Dropbox | Dropbox is currently supported. | |
Google Drive | Google Drive is currently supported Starting in 4.5.9 | |
AWS | This is currently not supported. | |
OneDrive | This is currently not supported. |
<Files *.php>The presence of an .htaccess file in wp-content does not necessarily prevent execution. Solution: Temporarily rename the htaccess file
Order Deny,Allow
Deny from all
</Files>
Listen 80
Listen 8080
<VirtualHost *:*>
For more details
to this solution see stack overflow.
<Directory />
Options Indexes FollowSymLinks Includes ExecCGI
AllowOverride All
Require all granted
Allow from all
</Directory>
Solution 3
Troubleshoot: To troubleshoot this issue place two files called test.html and test.php in the same directory as the installer.php file. Then try to browse out to both of them via a web browser. If neither work then your site is not setup to server from the location at which they are placed. If only the test.html file works then PHP may not be properly enabled on your web server. If your not sure about how to configure your web server to server from the proper path or serve up PHP files then contact your hosting admin as these are not issues the plugin will be able to fix.
<?php phpinfo(); ?>
If this works and you see the text "PHP Version" at the top followed by other PHP settings info then continue to the other options below, if not then something is wrong with the web-server setup and you will need to contact your host or server administrator. $_SERVER['HTTP_X_ORIGINAL_HOST'] = $_SERVER['HTTP_X_FORWARDED_HOST'];
Also See:
How to handle "Internal Server 500" messages?
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. For example a similar question using MAMP was
found here.
1f8b 0800 0000 0000 0003 ecfd 7b57 1bb9
d228 0eff 9dbd d6fe 0e8d 7706 ecd0 3636
09b9 d8e9 7813 7012 26dc 8221 2401 86a7...
- OR -
Warning: Unexpected character in input: '?' (ASCII=17) state=0
Then the web server may have some issues with pushing the file down to your computer. The easiest way
to get a good copy of the installer is to try the following:
AddHandler x-httpd-php5 .php
or with CGIAddHandler x-httpd-php5-cgi .php
Consider these handlers for your version of PHP.
Also see:
Why can't I download files / get a corrupted installer / see a 404.3 message?
<VirtualHost *:80>
{various instructions}...
<Directory /var/www/html>
AllowOverride All
</Directory>
</VirtualHost>
Status | Details |
---|---|
Pass | The check passed and there are no issues detected |
Notice | An issue has been detected however the risk is very low. Continue with the install process and if you run into issues then consider getting the notice fixed. |
Warn | An issue has been detected and the risk of install issues is high. You may continue with the install, however it is recommended that you address the issue if possible. |
Fail | A critical issue has been detected and the install will be halted, until the issue is resolved |
---
# Use PHP7 Single php.ini as default
AddHandler application / x-httpd-php70s .php
---
GRANT SHOW_ROUTINE ON *.* TO <USER>@<LOCATION>
sql=mysqldump: Error: 'Access denied; you need (at least one of) the PROCESS privile ...
To work-a-round these issues you have a few options:
...
/*!40111 SET @[email protected]@SQL_NOTES, SQL_NOTES=0 */;
/*!40101 SET @saved_cs_client = @@character_set_client */;
/*!40101 SET character_set_client = utf8 */;
So in the event the installer reported an error such as:
'Variable 'character_set_client' can't be set to the value of 'NULL'' - [sql=/*!40101 SET character_set_client = @saved_cs_client */;...]
Then you might simply try to remove the last line, save the dup-database_[hash].sql file and run the installer again. If the issue persists check
the errors till the version of msyql/marida is satisfied with the directives set. If the database engine versions are too far apart then it would
be recommend to work with your host or server admin to bring the version closer together.
<?php // Update the 4 parameters to match your server requirements // Create connection $conn = new mysqli($servername, $username, $password, $dbname); // Check connection if ($conn->connect_error) { die("Connection failed: " . $conn->connect_error); } echo "Success: A proper connection to MySQL was made! The my_db database is ready to use ." . PHP_EOL; echo "Host information: " . mysqli_get_host_info($conn) . PHP_EOL; ?>
[mysqld]
port = 3306
sql_mode=NO_ENGINE_SUBSTITUTION
[mysqld]
sql_mode=IGNORE_SPACE, NO_ZERO_IN_DATE, NO_ZERO_DATE, ERROR_FOR_DIVISION_BY_ZERO, NO_AUTO_CREATE_USER, NO_ENGINE_SUBSTITUTION
EXCEPTION message: DB ERROR: Could not get the CREATE query for the table wp_XYZ. Incorrect information in file: './database_store/wp_XYZ.frm'
DATABASE ERROR: This function has none of DETERMINISTIC, NO SQL, or READS SQL DATA in its declaration and binary logging is enabled (you *might* want to use the less
safe log_bin_trust_function_creators variable)
Execute the following in the MySQL console OR add the following to the mysql.ini configuration file:
SET GLOBAL log_bin_trust_function_creators = 1;
log_bin_trust_function_creators = 1
The setting relaxes the checking for non-deterministic functions. Non-deterministic functions are functions that modify data (i.e. have update, insert or delete statement(s)).
For more info, see here. For complete details see
this article.
Tablespace for table xxx exists. Please DISCARD the tablespace before IMPORT
For a full run-down of all the possible solutions for this issue see
this stack-overflow article.
**ERROR** database error write 'Unknown collation: 'utf8mb4_unicode_ci'
will be triggered because the MySQL version being used does not support this table format. You can view the MySQL server version comparison by clicking on the 'Test Connection' button in the installer or by viewing the installer-log.txt file. The output will look something like:MYSQL VERSION: This Server: 5.4.22 -- Build Server: 5.7.10
Also see:
Recommended hosting providers for Duplicator?
http://dev.mysql.com/downloads/mysql
https://make.wordpress.org/core/2015/04/02/the-utf8mb4-upgrade
DirectoryIndex index.html index.php
to .htaccess
<IfModule mod_security.c>
SecFilterRemove 001838
</IfModule>
Also See:
How do I handle "Internal Server 500" messages?
Wordfence documentation
ModSecurity Site | ModSecurity Reference
Recommended hosting providers for Duplicator?
Also see:
How to fix database write issues?
How to fix database connection issues?
Recommended hosting providers for Duplicator?
# The Directory path below should match your server the following is a SAMPLE
<Directory /var/www/html/example.com/public_html>
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
Solution 3
Additional ResourcesAlso See:
WPBegginer: How to Fix the 403 Forbidden Error in WordPress.
How to fix a blank/white installer or 403/404/405/500 issues?
# The Directory path below should match your server the following is a SAMPLE
<Directory /var/www/html/example.com/public_html>
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
Also See:
How can I fix my site when the home page shows but no sub-pages work?
Why are some of my plugins/images/links/styles not updating?
WordPress.org Forums: 404 Errors on all pages but home page?
PHP ERROR: Unexpected end of file
PHP WARNING: Use of undefined constant
a2enmod rewrite
/etc/init.d/apache2 restart
WAMP Instructions here |
IIS Instructions here
Also See:
Issue B
Why are some of my plugins/images/links/styles are not updating?
Why do I get a blank/white screen on my site?
WPBegginer: How to Fix WordPress Posts Returning 404 Error.
Also see:
Why can't I download files / get a corrupted installer / see a 404.3 message?
How can I fix my site when the home page shows but no sub-pages work?
Also See:
How can I fix my site when the home page shows but no sub-pages work?
Also See:
How does Duplicator handle data/file migration?
* Please make sure FTP account has visibility of and write access to WordPress directory. We recommend setting up a temporary account if possible. FTP is preferred over control panel account (cpanel)
VERY IMPORTANT! Please read all instructions to help diagnose your issue quickly. Copy and paste the text from the box below into your help ticket using the exact format.
To get the URL follow these steps:
1. Login to your SOURCE WordPress Admin where the archive.zip/daf file was created.
2. Goto ❯ Duplicator ❯ Package Row ❯ Details ❯ General ❯ Share File Links ❯ Copy/Paste Archive URL
-OR-
Supply a link to the archive.zip/daf file to use for IMPORT.
This could be a link from Google Drive, Dropbox, etc.
This is where you want the package installed - THIS SITE WILL BE OVERWRITTEN!
The FTP server where the import will run. This is optional, but recommended to recover site in the event of a critical failure.
=========== SENSITIVE INFORMATION END ===========
Import Type | Data Status |
---|---|
Single Site Overwrite | All Tables/Files Replaced |
Full Multisite Overwrite | All Tables/Files Replaced |
Add A Multisite-Subsite | New Tables/Files Added |
Replace A Multisite-Subsite | Subsite Tables/Files Replaced |
Also See:
How to resolve 403/500/timeout issues on step 3?
How to Fix the 500 Internal Server Error on Your WordPress Website
Recommended hosting providers for Duplicator?
define('WP_MEMORY_LIMIT', '500M');
2. Edit your .htaccess file in your WordPress root
<IfModule mod_php5.c>
php_value memory_limit 500M
</IfModule>
3. Edit the php.ini and set:
memory_limit = 500MB
Bitnami users click here
Also see:
What can I try for timeout issues?
What can I do for issues with migrating a large site?
Recommended hosting providers for Duplicator?
Also see:
What can I do for issues with migrating a large site?
Recommended hosting providers for Duplicator?
define("DB_CHARSET", "utf8");
define("DB_COLLATE", "");
Try using no options or commenting them out
define("DB_CHARSET","");
define("DB_COLLATE","");
//define("DB_CHARSET", "some_value");
//define("DB_COLLATE", "some_value");
Try various options UTF8MB4 to UTF8
define("DB_CHARSET", "utf8mb4");
Try just utf8:
define("DB_CHARSET", "utf8");
INSTALLER ERROR: [PHP ERR][FATAL] MSG:Uncaught Error: Call to undefined function token_get_all() in /var/www/localhost/htdocs/wordpress/duplicator/dup-installer/lib/config/class.wp.config.tranformer.php:387Then simply send the message to your host or server admin and they can typically enable the undefined function call.
# BEGIN Line too long fix
<IfModule mod_substitute.c>
SubstituteMaxLineLength 10M
</IfModule>
# END Line too long fix
Also see:
... My name is Jelmer Verkleij, CTO at Patchman. This issue was brought to our attention about 30 minutes ago and after some quick research we noted that these detections are the result of an error in our definition development process. All detections of the installer/build/assets/inc.libs.js.php file in the duplicator plugin folder seem to be false positives at this point. My sincere apologies for the confusion - this should of course not have happened and naturally we have immediately started looking into how and why this went wrong, and what needs to be done to prevent this from happening again in the future.
In the meantime, we have deployed a definition update to all our Patchman customers that rolls back any automated quarantine actions that took place for these files, and retracts the associated detections. This should automatically restore all websites to their original state without problems.
Once again, I sincerely apologize for this inconvenience, and I would like to reiterate that we are taking this matter very seriously. If you have any further questions or comments you have regarding this incident, please don't hesitate to let me know here or by sending an e-mail to [email protected] I will make sure to address each response as soon as possible.
Best regards,
Jelmer Verkleij
Patchman B.V.
php_value auto_prepend_file "/path_to_file/wordfence-waf.php"
Check your php.ini or user.ini and remove the following:
auto_prepend_file = '/home/username/website.com/wordfence-waf.php
Also See:
How to resolve 403/500/timeout issues on step 3?
Duplicator Lite > Settings > Packages > Archive Engine = DupArchive
Duplicator Pro > Settings > Packages > Basic Settings > Archive Engine = DupArchive
# Example .htaccess file Inserted By Customer Control Panel SetENV PHPRC /home/username/public_html # BEGIN WordPress <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteRule ^$ - [E=noabort:1] ... </IfModule> # END WordPressEXAMPLE 2 fcgi setup
<IfModule mod_fcgid.c> AddHandler fcgid-script .fcgi FcgidIOTimeout 900 ProcessLifeTime 7200 IPCConnectTimeout 180 IPCCommTimeout 7200 </IfModule>EXAMPLE 3 litespeed setup
<IfModule litespeed> RewriteRule .* - [E=noabort:1] </IfModule> OR <IfModule Litespeed> RewriteEngine On RewriteRule .* - [E=noconntimeout:1] SetEnv noabort 1 </IfModule>
Also see:
What can I do for issues with migrating a large site?
How to run the installer in Database Only Mode?
Recommended hosting providers for Duplicator?
If your moving from https to http or vice versa and run into issues below is a check-list of possible work-a-rounds:
RequestHeader set X-Forwarded-Proto "https"
RequestHeader set X-Forwarded-Port "443"
Also see:
Permissions set to 777 and file still not writeable
How to change file Permissions with FTP clients like Filezilla
Also See:
How can I configure PHP open_basedir?
How can I relax PHP's open_basedir restriction?
Replace: return $hash === $stored_hash;
With: return true;
Need a little help? Check out our Partners at Codeable
define( 'DOMAIN_CURRENT_SITE', 'www.example.com' );For more details visit this forum thread.
Settings ❯ Storage ❯ Storage Types ❯ Amazon S3 and set "Upload Size" to 1000kb.This will decrease the amount of data Duplicator sends and should help to stabilize intermittent network problems.
Settings ❯ Storage ❯ Storage Types ❯ Dropbox and set "Upload Size" to 1000kb.This will decrease the amount of data Duplicator sends and should help to stabilize intermittent network problems.
Settings ❯ Storage ❯ Storage Types ❯ Google Drive and set "Upload Size" to 1000kb.This will decrease the amount of data Duplicator sends to Google Drive and should help to stabilize various intermittent network problems.
If you need to authorize multiple programs, machines, or devices, one workaround is to limit the number of clients that you authorize per user account to 15 or 20. If you are a G Suite admin, you can create additional admin users and use them to authorize some of the clients.
Settings ❯ Storage ❯ Storage Types ❯ OneDrive and set "Upload Size" to 1000kb.This will decrease the amount of data Duplicator sends and should help to stabilize intermittent network problems.
"ALTER TABLE table_name ENGINE=InnoDB;"For more information you can read this post titled Converting Tables from MyISAM to InnoDB
Also see:
How to resolve various Database Issues?
GoDaddy may be the most resource-constrained of all the major web hosts. Because of this, if your site is over 150MB you may have to switch from the zip format to the DupArchive format which was developed to work on restricted hosts.
To build a package using DupArchive:
When installing to GoDaddy you may experience a timeout. To avoid a timeout perform a manual extraction install as described in the answer to FAQ question How do I do a Manual Extraction?
RewriteEngine On RewriteCond %{REQUEST_URI} ^/ RewriteRule .* - [CO=wordpress_test_cookie:WP+Cookie+check:% {HTTP_HOST}:1440:/]Reference: Guide on One.com
License activation from TSOHost may not work for you. TSOHost has a many spam sites running off of some of their shared IP addresses so those IP addresses have gotten added to black lists which our provider blocks.
Important:Even though your product will not be activated it will still fully function (licensing just controls auto-update).
To minimize this impact:
1) Enter your license key in the license key area and click activate - the plugin won't activate but it will save the license key in that spot - this will prevent a very large nag bar at the top from popping up in 30 days (right now you'll get the smaller one that tells you to activate a license)
2) Periodically check https://snapcreek.com/dashboard for a new copy of the plugin - once a month is adequate. If/when you see a new copy download it, uninstall the old one and install the new one.
Connectivity with TSOHost is an ongoing problem with our and other providers who monitor misbehaving sites. If you have an account with TSOHost we recommend you talk to them about removing these bad-apple sites since they impact all of TSOHost's customers.
Also see: Snapcreek recommended WordPress Hosting
/public_html/mysite1/(wp files)
/public_html/mysite2/(wp files)
/public_html/mysite3/(wp files)
STEP 3: Create Databases Each site will needs is own database. Typically
the best practice is to name the database similar to the directory (which is most cases is the domain name).