Dropbox

This guide shows how to add a Dropbox backup destination to JetBackup.

Configuration

First make sure that you have the appropriate Dropbox destination plugin installed and enabled.

When creating the Destination, you will be prompted to install the Dropbox plugin and can click "Install Now" to install and enable the plugin.

Next, fill in the Backup Directory with the path you'd like to store your backups.

Then, click "Request Acces Code" to authorize JetBackup to read and store files it creates using your Dropbox account. Proceed through the popup window until you receive an Access Code, which you can then paste in the "Request Acces Code" text field.

An example Dropbox Configuration page for the destination:

Dropbox Destination


An example of the Dropbox App authorization popup after clicking "Request Access Code". If you are already signed in to Dropbox, you will receive a new access code automatically.

Dropbox Authorization popup

Destination Name

Specify a unique name for your destination. This will be used internally for your convenience.

Read Only

This option allows you to add the destination as a "Read Only" destination. You can only restore and download existing backups from a read-only destination. Read Only is required if the Backup Directory is already owned by another destination/server. This option is only selectable upon creating the destination and will be automatically enabled for any destinations added during a Disaster Recovery.

Owner

Specify the owner for this destination. This grants the owner and its parent account(s) permission to modify and delete this destination. Please note that the owner specified will also need Can Manage Destinations permission granted under the Permissions section.

Maximum Concurrent Threads

This option allows you to set the number of worker threads that can be used by the destination for upload/download/get/delete requests. This will be shared evenly across the number of Concurrent Tasks set for Backup or Restore/Download. As the tasks complete, the available threads will be allocated to the remaining active tasks up to the set limit. You can lower this value if you receive rate-limit errors from the remote destination.

Backup Directory

This will be our starting point when accessing this destination. Always use the absolute path and make sure to start with "/".
For example: /PATH/TO/FOLDER.
Note: The absolute path must be unique and can not be used by two different Destination Configurations. If a backup directory is already owned by another JetBackup Destination, you may create a "Read Only" Destination to that path.

Request Access Code

This option allows you to generate a secure access token for the purpose of storing and retrieving snapshots that were uploaded from your server using JetBackup.

HTTP Retries

Controls how many retries will be attempted if the destination returns an error for an HTTP call (upload / download / delete). [ default: 3 retries ]