Duplicator Documentation

Documentation, Reference Materials, and Tutorials for Duplicator

Want it done for you?

Let the Duplicator experts migrate your WordPress site for you — quick, safe, and hassle-free.

Get Migration Help

How to Use AutoTune to Find the Best Backup Settings for Your Server


Are your backups failing or timing out, and you’re not sure which archive engine or database setting your server needs? AutoTune, a tool in Duplicator, our backup and migration plugin, runs real test backups on your server and keeps the fastest configuration that completes.

In this guide, we’ll show you how to use AutoTune to find the best backup settings for your server.

Before you get started, make sure no backup is building or transferring. AutoTune doesn’t start while another backup is running. Your WordPress user also needs permission to change Duplicator settings and to create backups.

What AutoTune Does

AutoTune runs a series of real, full-site test backups. The first test uses the fastest configuration your server supports. When a test backup fails, AutoTune looks at the reason, changes only the setting related to that failure and runs the next test. When a test backup completes, the session ends and that configuration stays active for your future backups.

AutoTune manages six backup settings. The table below shows the name each setting has in AutoTune, where to find it in Duplicator Pro > Settings > Backups, and the value AutoTune starts with:

AutoTune settingOn the Settings pageStarting value
Archive EngineArchive sectionThe fastest engine your server supports: Shell Zip, then ZipArchive, then DupArchive
CompressionArchive Compression in the Archive sectionOn, when the engine supports it
ZipArchive Chunk SizeBuffer Size under ZipArchive Options128 MB
Database DumpDatabase sectionMysqldump, then PHP Code
Query LimitQuery Size under PHP Code Options1M
Server Load ReductionServer Throttle in the Processing sectionOff

Notes:
– AutoTune also sets the ZipArchive and PHP Code process modes to Multi-Threaded.
– AutoTune never changes your server. It checks your PHP limits, how backup workers start and whether process locks work, then explains how to improve them. Those changes are made by you or your hosting provider.

Opening AutoTune

To open AutoTune, navigate to Duplicator Pro > Tools and click the AutoTune tab.

Screenshot of Duplicator Pro AutoTune page in WordPress admin, showing Server Overview and backup options with green checkmarks and warning icons.

AutoTune is also one click away on the Backups page. Click the AutoTune button at the top right of the page.

Duplicator plugin dashboard on WordPress, Backups page with Cloud Dashboard and AutoTune buttons on the top-right. The left admin menu is visible as well as the toolbar above the backups list.

Until AutoTune runs for the first time, our plugin also displays an Optimize Backup Settings with AutoTune notice on its pages. Click the AutoTune link in the notice to open the page. Dismissing the notice hides it permanently.

Screenshot of Duplicator Backups page showing the 'Optimize Backup Settings with AutoTune' notification banner with a close (X) button on the right.

When a backup fails for a reason that a settings change is able to fix, its error notice also includes a Recommended: line with a link to run AutoTune.

Reviewing the Server Overview

The Server Overview section shows what your server offers to the backup process. Our plugin runs these checks again each time the AutoTune page opens, so the overview always reflects your current server.

Each item appears as a chip with a status icon:

  • Green check: the item is ready.
  • Yellow warning: a suggestion. AutoTune still runs, but enabling the item widens the configurations it tests.
  • Red cross: a blocking problem. The Start AutoTune button stays disabled until it’s fixed.

The counters next to the section title add up the chips by status. The chips are grouped in four rows:

  • Archive Engine: Shell Zip, ZipArchive and DupArchive. An available engine also shows a warning when compression or encryption isn’t supported with it.
  • Database Dump Engine: Mysqldump and PHP Code.
  • Backup Workers: the Kickoff mode chip shows whether your server starts the backup workers on its own (server-side) or needs your browser to start them (client-side). It also covers the AJAX endpoint and password-protected access settings. The locks chip shows whether the SQL and file process locks work on your server.
  • PHP Limits: Execution time and Memory limit.

DupArchive and PHP Code are AutoTune’s fallbacks. If either one is missing, or no process lock works on your server, its chip turns red and AutoTune doesn’t start.

Click any chip to see its details. The dialog explains the current state, lists troubleshooting steps and links to documentation or to the related settings page.

Dialog: Archive Engine — Shell Zip not available on this server, with troubleshooting notes and a Close button in the Duplicator UI

Starting an AutoTune Session

To start a session, click the Start AutoTune button in the Session panel.

AutoTune screen with server overview and a prominent Start AutoTune button on the right edge.

The Start AutoTune dialog opens. It reminds you that AutoTune runs real full-site test backups, changes your backup settings and blocks other backups until the session ends.

Choosing the Configurations to Test

Under Configurations to test, every option your server supports is checked. Clear a checkbox to skip that option during the session. For example, clear Shell Zip to keep AutoTune from testing it.

Some checkboxes are locked:

  • DupArchive and PHP Code are the fallback values, so AutoTune always tests them.
  • Options your server doesn’t support are grayed out.

To test only without compression, clear the On checkbox next to Archive Compression. AutoTune remembers your choices for the next session.

Note: On LiteSpeed web servers, Shell Zip is unchecked by default because LiteSpeed often interrupts the zip process. Check it to include it in the session, although we don’t recommend it.

Once you’re ready, click Run AutoTune.

Screenshot of Duplicator Pro's Start AutoTune modal showing server and test configurations with a highlighted Run AutoTune button in the bottom-right corner.

What Happens During the Session

While the session runs, AutoTune takes over the backup process:

  • Manual backups are blocked, and the Add New button is disabled until the session ends.
  • Active backup schedules are paused and turn back on automatically when the session ends.
  • Incremental backups wait for the session to end.
  • The running test backup can’t be deleted or cancelled from the Backups page. To stop it, abort the session.

Note: AutoTune changes your backup settings while it runs. The changes stay in place after the session ends, even when it fails or you abort it.

The Tuning Session section lists each attempt with the configuration tested, its status, start time and duration. A progress bar follows the running test backup. Below each attempt title, a highlighted label shows what changed compared to the previous attempt, such as ZipArchive Chunk Size: 128 MB → 32 MB. Click that label to see every setting of the attempt and a link to its test backup.

The Session panel shows the status, the number of attempts and how long the session has been running.

Dashboard of a server backup test with sections: Server Overview, Tuning Session, and a session status panel on the right.

How AutoTune Picks the Next Configuration

After a failed test backup, AutoTune changes only the setting related to the failure:

  • Archive failures: AutoTune moves to the next archive engine, from Shell Zip to ZipArchive and then to DupArchive. When ZipArchive fails on a timeout, AutoTune first tries again with a 32 MB chunk size.
  • Database failures: AutoTune switches from Mysqldump to PHP Code. When the database export is interrupted, it first lowers the query limit to 128K.
  • Last try: when nothing else is left to test, AutoTune runs one more test with Server Load Reduction set to Low.

AutoTune never tests the same configuration twice and skips any option you cleared in the start dialog.

Some failures aren’t related to backup settings, for example a full disk, wrong folder permissions or a backup that stalls because the server doesn’t run its background workers. In these cases, AutoTune stops right away and explains what to fix.

Keeping the Page Open

AutoTune runs in the background. When your server uses the server-side kickoff mode, close the page at any time and the session keeps going. When the Kickoff mode chip shows the client-side mode, your browser starts each backup step, so keep the AutoTune page open until the session ends.

A session stops automatically after one day.

Aborting a Session

To stop a session, click Abort Session in the Session panel and confirm. AutoTune cancels the running test backup, which takes a few minutes to finish. Your backup settings keep the last tested configuration.

Understanding the Results

When a test backup completes, the status changes to Completed. The Results section compares your settings Before AutoTune and After AutoTune and highlights each value that changed. The new settings are already active, so your next backups use them.

Dashboard showing AutoTune backup server overview, tuning session, results, and a right-side session panel with a Restart AutoTune button.

To review every attempt, open the Tuning Session section. The successful attempt shows its full configuration and a link to its test backup.

Overview of a backup tuning dashboard showing server status: Completed session with green and warning icons and a Restart AutoTune button nearby on the right panel.

If no configuration works, the status changes to Failed and the Results section shows AutoTune could not find a working configuration, with the error from the last test backup and troubleshooting steps. Some errors also include a suggested server configuration with a Copy button and a link to our documentation. Below the error, AutoTune suggests three next steps:

  • Review the suggestions in the Server Overview. Enabling a suggested option widens what AutoTune tests on the next run.
  • Click Duplicator Logs to see where each test backup stopped.
  • Click Get help to contact our support team.
Dashboard screenshot of an AutoTune session: three steps (Server Overview, Tuning Session, Results) with status icons, and a right panel showing Session Status: Failed, 4 attempts, duration 2 minutes, plus a Restart AutoTune button.

A session also ends with one of these statuses:

  • Aborted: you stopped the session.
  • Timed out: the session reached its one-day limit.
  • Error: AutoTune couldn’t continue, for example because its test backup was deleted or another backup started.

As with Failed, your settings keep the last tested configuration. To run AutoTune again, click Restart AutoTune.

Finding the Test Backups

Each test backup is a full backup of your site, created with your default template and saved to your default storage. In the Backups list, a magic wand icon marks the backups created by an AutoTune session.

Screenshot of Duplicator plugin Backups page in WordPress admin, showing a backup named 20261028_duplicatordocsreview with action icons (download, restore) and status indicators.

The successful test backup stays in your list like any other backup. Failed test backups are removed automatically by our plugin’s regular cleanup. AutoTune events also appear in the Activity Log with the AutoTune label.

Note: When your default storage keeps a limited number of backups, the successful test backup counts toward that limit. Once the limit is reached, our plugin removes your oldest backup to make room.

If your default template encrypts the archive, AutoTune skips any archive engine that can’t encrypt on your server.

FAQs

Below, we’ve addressed some of the most common questions regarding this feature.

Will AutoTune change my backup settings?
Yes. AutoTune changes the six settings listed at the top of this guide while it runs, and keeps the configuration of the successful test backup. Your templates, storages and other settings stay as they are.
How do I undo the changes AutoTune made?
AutoTune doesn’t have an undo button. The Before AutoTune column in the Results section lists your previous values. To go back, set them again in Duplicator Pro > Settings > Backups.
Do I need to keep the AutoTune page open?
Only when your server uses the client-side kickoff mode. Check the Kickoff mode chip in the Server Overview.
What happens to my scheduled backups during a session?
Active schedules are paused when the session starts and turned back on when it ends.
Why can’t I create a backup right now?
An AutoTune session is running. Wait for it to end, or click Abort Session on the AutoTune page.
Why is the Start AutoTune button disabled?
The Server Overview shows a red check. Click the red chip to see the cause and the steps to fix it. Your WordPress user also needs permission to create backups.
Why did AutoTune stop after one attempt?
The test backup failed for a reason that backup settings can’t fix, such as missing disk space or folder permissions. The Results section explains what to fix. Once it’s fixed, click Restart AutoTune.
Do I need to run AutoTune again after migrating my site?
Yes. AutoTune results depend on the server. After you migrate or restore a site, AutoTune resets to Never run and its notice appears again, so run it on the new server.
Is AutoTune available in Duplicator Lite?
Yes. AutoTune is available in both the Lite and Pro versions.
Can I run AutoTune from WP-CLI?
No. AutoTune runs from the AutoTune page only.

That’s it! You now know how to use AutoTune to find backup settings that work on your server and how to read its results.


Was this article helpful?


Don't Let Another Day Pass Unprotected

Every hour without proper WordPress backups puts your site at risk • Every delayed WordPress migration costs you performance and growth

Get Duplicator Now
Duplicator Plugin

Wait! Don't miss your
exclusive deal!

As a customer, you get 60% OFF

Try Duplicator free on your site — see why 1.5M+ WordPress pros trust us. But don't wait — this exclusive 60% discount is only available for a limited time.

or
Get 60% Off Duplicator Pro Now →