Overview
The panel backup option is a very simple way to backup your entire account, including all users, databases, and mailboxes.
The following describes how to use this feature in the panel as well as how to download a backup file using various tools.
Backing up your account
- Visit the Manage Account page.
- Scroll down to the Back Up Your Account section.
- Click the Create a Backup button to open the panel backup page.
- Click the Back me up! button.
The backup process begins and takes some time to complete based on how much content there is to backup. You are notified via email once this completes.
Confirmation of your backup
The notification email you receive links you back to the Backup Your Account page, where you see the details below:
Viewing your backup
Once the backup completes, you'll see all of your files listed in your panel with .tar.gz or .sql.gz extensions.
You'll see links like these:
Mail users appear like this:
- mail/user@example.com.tar.gz
Databases appear like this:
- mysql/databasename.sql.gz
Users appear like this:
- user/servername_username.tar.gz
The Size column shows the size of each file. All of the backups are listed as a .tar.gz or .sql.gz file and are temporarily hosted on DreamObjects for you to download locally.
Downloading your backup via the command line
Mac and Linux
You can download these files directly to your server or Mac OSX / Linux computer using either curl or wget commands.
Windows
If you're running Windows you'll need to install curl. You'll need to download the zip file from the Win64 - Generic section.
curl
Here is an example of how to download a single file using the curl command:
- Right-click on the backup link in the panel. In this example, it's the user/servername_username.tar.gz file.
- From the popout menu, choose Copy Link Location/Address. Paste this into a simple text editor to save for now. It will be a very long URL.
- Open a terminal (if you're using Mac or Linux) or command prompt (if using Windows).
- Run the curl or wget command to download the file.
curl example
Run the curl command with the following syntax:
curl --insecure --output filename.tar.gz "COPIED_LINK_LOCATION"
The filename.tar.gz is one of the file names in your panel on the Backup Your Account page. Make sure you DO NOT include the first part of the filename before the forward slash. If the link in the panel is user/servername_username.tar.gz, the filename would just be 'servername_username.tar.gz'.
The COPIED_LINK_LOCATION is the link you copied when you right-clicked the filename and saved the link.
Here is full curl example:
Make sure you put the full URL in double quotes. If you do not, the command will not download the file.
[server]$ curl --insecure --output servername_username.tar.gz "https://objects-us-east-1.dream.io/accountbackup/1358572/2016-12-06-SLRG8WEQ57K6CQTE/user/server_username.tar.gz?AWSAccessKeyId=2XoecBOZcL8WQXo9DT9E&Signature=9HWxQE28LaYxxGXX6NsvcEELAwE%3D&Expires=1451659279"
wget
Run the wget command with the following syntax:
wget --no-check-certificate --output-document=filename.tar.gz "COPIED_LINK_LOCATION"
The filename.tar.gz is one of the file names in your panel on the Backup Your Account page. Make sure you DO NOT include the first part of the filename before the forward slash. If the link in the panel is user/servername_username.tar.gz, the filename would just be servername_username.tar.gz.
The COPIED_LINK_LOCATION is the link you copied when you right-clicked the filename and saved the link.
Here is full wget example:
Make sure you put the full URL in double quotes. If you do not, the command will not download the file.
[server]$ wget --no-check-certificate --output-document=servername_username.tar.gz "https://objects-us-east-1.dream.io/accountbackup/1358572/2016-12-06-SLRG8WEQ57K6CQTE/user/server_username.tar.gz?AWSAccessKeyId=2XoecBOZcL8WQXo9DT9E&Signature=9HWxQE28LaYxxGXX6NsvcEELAwE%3D&Expires=1451659279"
Clicking the file link to download
You can also click on each file to download them one at a time to your computer. There is unfortunately no way to download all files at once.
Decompressing the downloaded files
Once it's downloaded to your computer, it is in a compressed .tar.gz or .sql.gz file format.
- If you're using a Windows computer you'll need a program to decompress the file type such as 7-Zip.
- If you're using a Mac or Linux computer you can run the following command to decompress the .tar.gz file:
macbook$ tar -zxvf user\@example.com.tar.gz
macbook$ gunzip databasename.sql.gz
Troubleshooting
If you believe the automated backup did not backup everything in your account, please contact support for further assistance.