On this page

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

ProtocolDescription
s3://Wasabi Storage URL

Setting Up Wasabi Storage and Finding Credentials

1
Creating a Bucket in Wasabi

  1. Sign in to the Wasabi cloud storage console.
  2. Navigate to the "Buckets" section and create a new bucket.
  3. Choose a name for your bucket and select the appropriate region.

2
Finding Your Wasabi Credentials

  1. In the Wasabi console, go to your account settings.
  2. Access the 'Access Keys' section to find or create your Wasabi access key (storage account name) and secret key (storage account key).
  3. See How do I use Qencode with Wasabi? for more details.

3
Saving 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

AttributeDescription
keyYour Wasabi storage account name.
secretYour Wasabi storage account key.
permissionsSpecifies 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

Components of URL
regionThe Wasabi region your bucket is located in.
bucketYour Wasabi bucket name.
pathPath 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.