Saving to Wasabi
Introduction
This tutorial is tailored to guide you through saving files to Wasabi, an S3-compatible cloud storage service.
Upon completing this tutorial, you will be able to to configure a destination object for saving files to Wasabi, as well as specify the correct URL structure and credentials.
Supported Destinations
Protocol | Description |
---|---|
s3:// | Wasabi Storage URL |
Setting Up Wasabi Storage and Finding Credentials
1Creating a Bucket in Wasabi
- Sign in to the Wasabi cloud storage console.
- Navigate to the "Buckets" section and create a new bucket.
- Choose a name for your bucket and select the appropriate region.
2Finding Your Wasabi Credentials
- In the Wasabi console, go to your account settings.
- Access the 'Access Keys' section to find or create your Wasabi access key (storage account name) and secret key (storage account key).
- See How do I use Qencode with Wasabi? for more details.
3Saving Output to Wasabi
In order to save your outputs to your Wasabi Storage, define your destination object using the following structure.
Destination Object Structure
"destination": {
"url": "s3://s3.[region].wasabisys.com/bucket/path",
"key": "storage_account_name",
"secret": "storage_account_key",
"permissions": "permissions"
}
Attributes of Wasabi Destination Object
Attribute | Description |
---|---|
key | Your Wasabi storage account name. |
secret | Your Wasabi storage account key. |
permissions | Specifies object access permissions. The default value is ‘private’ meaning the object is not publicly accessible with its URL. In case you want your objects to be accessed publicly, specify ‘public-read’ as a value for permissions. |
URL Structure for Wasabi
The Wasabi url consists of a region, bucket and path. Check the examples for single file and ABR formats like HLS and DASH below:
s3://s3.<region>.wasabisys.com/bucket/path
When saving ABR outputs like HLS or DASH, please specify the path to a folder where the contents of the HLS or DASH stream should be located:
s3://s3.<region>.wasabisys.com/bucket/folder
region | The Wasabi region your bucket is located in. |
bucket | Your Wasabi bucket name. |
path | Path within your bucket where the file will be saved. |
Destination Object Example
"destination": {
"url": "s3://s3.us-east-1.wasabisys.com/my-bucket/folder/output.mp4",
"key": "myWasabiAccountName",
"secret": "myWasabiAccountKey",
"permissions": "public-read"
}
When saving ABR outputs like HLS or DASH, please specify the path to a folder where the contents of the HLS or DASH stream should be located:
"destination": {
"url": "s3://s3.us-east-1.wasabisys.com/my-bucket/folder",
"key": "myWasabiAccountName",
"secret": "myWasabiAccountKey",
"permissions": "public-read"
}
Considerations for Wasabi
-
Region Selection: Choose a region closest to your location for better performance. You can find the list of available regions in the official Wasabi documentation.
-
Compatibility: Wasabi is S3-compatible, so it works with tools that support Amazon S3.
-
Connectivity Issues: Ensure the region in the URL matches the region of your bucket.
-
Authentication Errors: Verify that your Wasabi keys are entered correctly.
-
Explore advanced features of Wasabi, such as object lifecycle management and data immutability.