This guide shows how to add an S3 compatible backup destination to JetBackup.
WARNING - EXPERIMENTAL
JetApps does not guarantee the error-free functionality of experimental features, and we provide it on an experimental basis only. You assume all risk for any feature that you use marked "Experimental". Use of this feature could cause functionality failures, even for experienced administrators. Eventually this feature will be released to our STABLE tier, once adequate testing and refinement is complete.
First make sure that you have the appropriate S3 destination plugin installed and enabled.
Create a bucket on the backup destination (for instructions on creating buckets for your corresponding S3 Vendor, please click here).
If you do not see your S3 Provider listed as an available Vendor, please note that you may be able to add your S3 Compatible Destination as a Custom Vendor.
Create New Access Key and Secret Key Pair and save them for the credentials on creation page.
An example S3 configuration page for the destination:
Specify a unique name for your destination. This will be used internally for your convenience.
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.
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.
Choose which S3 compatible vendor you will be using as your S3 destination.
A Custom Vendor must be fully S3-Compatible to be used with JetBackup. Choosing to use a custom vendor will require the additional Endpoint field. Please note that JetBackup automatically updates the endpoint with the Region from below. The correct format for the endpoint will use {region}
in place of the actual region.
Example Configuration:
us-east-1
and replace the {region}
with the inputted field whenever needed.{bucket}
depending on the endpoint format. This is not required for most S3 destinations.Example Custom Vendors:
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.
Only the following characters are allowed for the Backup Directory Path: A-Z a-z 0-9 and /
This is in accordance to the Amazon S3 Object key naming guidelines.
Every S3 Destination has a Access/Secret Key Pair you must use in order to create the destination. Please visit the specific documentation on creating these pairs for each S3 Destination.
Digital Ocean Object Storage - Creating an Access Key
Google Cloud Storage - Creating an HMAC Key
IBM Cloud Object Storage - Service credentials
- NOTE: Ensure to enable Include HMAC Credential to receive the key pair properly.
Oracle Cloud Object Storage - Create a Customer Secret Key
ScaleWay Elements - How to Generate an API Key
Wasabi - Creating a Wasabi API Access Key Set
Please visit the specific documentation on creating buckets for each S3 Destination.
Digital Ocean Object Storage - Create a Space
Google Cloud Storage - Creating storage buckets
IBM Cloud Object Storage - Getting started with IBM Cloud Object Storage
Oracle Cloud Object Storage - Create a Bucket in Oracle Object Storage
- NOTE: After creating a bucket, take note of the Namespace under Bucket Settings for your Destination Configuration on JetBackup.
ScaleWay Elements - Creating a Bucket through the Scaleway Console
Wasabi - Creating a Bucket
JetBackup will list known regions for the S3 Destination chosen. For a Custom Vendor, the region can be entered manually if required by the vendor. For more information, please see Custom Vendor.
It is best practice to choose the closest region to your server, if available, or consider a vendor with closer regions for best performance.
Whether SSL verification is enabled/disabled on the s3 compatible destination. [ default: Yes ]
Controls how many retries will be attempted if the destination returns an error for an HTTP call (upload / download / delete). [ default: 3 retries ]