With the import, you bring a backup that you downloaded as a file back into the list of backups, on this website or on another one where cloneworx Backup runs. Afterwards you restore it like any other backup.
What you need
- the backup file with the extension
.tar, as the plugin provided it when you downloaded it, - a usable target on this website: that is where the import stores the backup,
- free space in the work folder of the plugin the size of the file.
Without a usable target, nothing can be imported:
- Import to target is empty and disabled.
- No usable target: set one up on the Targets page first.
How to set up a target: Which target suits you?
Step 1: Open the tile
Open the Restore page and, in the main tile, click Import from file.
- Dismiss closes the tile.
- The upload area accepts the backup file.
- Choose file opens the file picker of your computer.
- Import to target offers the usable targets. The first one is preselected.
- Import is disabled as long as no file is chosen.
Step 2: Choose the file and the target
Drag the file onto the upload area, or click Choose file. Then, under Import to target, choose the target where the backup should be stored.
- The name and the size of the chosen file.
- Import to target shows the chosen target.
- Import starts the upload.
Step 3: Upload
Click Import. Leave the page open until the upload is finished. The upload runs in chunks: the first is 4 MiB, never larger than the server accepts (post_max_size). If the web server refuses a chunk or the connection is interrupted, the upload halves the chunk, down to 64 KiB.
- Buttons and dropdown menu are disabled. The tile cannot be closed during the upload.
- The bar shows the state of the upload.
- Uploading: … of …
The upload runs in parts. That is why large files can also be uploaded when your server limits uploads:
- The first part is 4 MiB in size, never larger than the server accepts.
- If the server refuses a part or the connection is interrupted, the page halves the part and tries again, down to 64 KiB.
- After every part, the server reports the position it has reached. If an answer gets lost, the page continues exactly from there.
Already while receiving the file, the plugin takes it apart and checks its structure. A file that is not a backup of this plugin ends the upload immediately.
If the website does not know the backup
If this website does not know the backup in the file, the dialog window Unknown backup opens after the upload: This website does not know this backup. That is normal when the backup comes from another website or the website has been set up anew. But this website cannot check whether the backup was changed after it was written. Only import the backup if you know where the backup comes from and you trust it.
- Confirm backup as correct and import it starts the import.
- Cancel removes the upload. Nothing is stored at the target, and the list of backups stays as it is.
- You import an encrypted backup without a key. The plugin asks for the recovery key only at the restore.
Step 4: Wait for checking and storing
After the last part of the upload, the import starts on its own.
- Upload complete; the backup is being checked and stored.
- The progress of the import with the current phase.
- Abort import aborts the import.
The import works in this order:
- Checking: The plugin reads every part of the backup against its checksum. A damaged part ends the import; nothing is stored.
- Transferring: The backup is transferred to the chosen target, in the same way as a new backup.
- Registering: The backup gets its entry in the list, and the plugin rewrites the catalog at the target.
- Cleaning up: The plugin removes the uploaded data from the work folder.
Step 5: Read the result
- The imported backup appears in the list under “…”. The message shows the target.
- The imported backup in the list. It is where it belongs according to the start of the original backup. As the date, the row shows the time of the import.
The tile closes. The backup is now in the list, including on the Backup page. If the import added it to the list as a new entry, the Extended view shows the word imported in the Plan column; on the Backup page, the Plan filter with imported shows only such backups. You can restore it via More …, then Restore: Restore the website from a backup.
If something does not work
If the upload or the start of the import already fails, the cause appears in red in the tile, after Import failed: …
| Cause in the message | What you can do |
|---|---|
| This file is not a backup file of this plugin. | Choose the file that the plugin provided when you downloaded it, unchanged. The file must contain exactly one backup. |
| The uploaded file does not contain a complete backup. | The file is missing the info file or a part, or a part has the wrong size. Download the backup again. |
| Not enough free space in the work folder for this file. | Free up space on the web server, and start the import again. |
| A backup with the same identifier is already stored at the target: …. | The message shows the identifier. The backup is already in the list. An import is not necessary. |
| A different backup with the same identifier is in the list: …. The file is not imported. | The list contains a backup with the same identifier and different content; the message shows the identifier. The plugin does not overwrite it. |
| The chosen target is not usable at the moment. | Test the target on the Targets page, or choose another one. |
| This upload is unknown or has expired. Start the import again. | The plugin removes an upload that gets no new part for an hour. Start the import again. |
| A job is already running. | Wait until the running job has finished. |
If the import fails later, during checking or transferring, a red message appears below the main tile:
- The message shows the cause. If the import fails at the target, it also shows the target and the message from the target or from the client.
- Log opens the log of the import.
The tile stays open with the chosen file. The plugin removes from the target whatever a failed or aborted import has already transferred there.
Good to know
- The plugin never automatically deletes a backup that the import adds to the list as a new entry. It does not count for Max. backups. It is kept until you delete it.
- It does not count for the warning about overdue backups.
- If the same backup is already stored at another target, the import does not create a second entry: the chosen target is added to the existing entry. The entry keeps what the Plan column shows. If that is one of your backup plans or manual, the backup also counts for Max. backups at the chosen target, and the plugin can delete it there automatically.
- The file may be at most 32 GiB in size.
- As long as a restore is running or its rollback is open, the main tile does not show the Import from file button.
See also
- Download a backup
- Restore the website from a backup
- Restore a backup on another website
- Find backups again after a reinstallation
- Restore and import with WP-CLI
On the command line
WP-CLI not set up yet? How to install WP-CLI.
If the backup file is already on the server, you can import it with WP-CLI without an upload. You specify the target with --target; without a target, the command does not start.
# Import a backup file to the target local-1 wp cloneworx-backup import /tmp/backup.tar --target=local-1 # Check whether the backup is in the list wp cloneworx-backup backup list
The command imports a backup that this website does not know only with --accept-unknown.