Adding a Wasabi Source
A Wasabi Source connects to an existing Wasabi bucket. imgix connects using the credentials you supply, so your Wasabi assets don't have to be public.
Setting Up Your Wasabi Source
-
Go to the Sources page (opens in a new tab) in the imgix dashboard and click the New Source button.
-
Select Wasabi from How do you store your media? radio options.
-
Fill in the details for the Wasabi Source.
Note: We strongly recommend creating Wasabi access keys specifically for imgix to access your bucket with. Keep in mind that imgix only requires
Read and List
permissions to begin serving your assets. For more information on how to generate your Access and Secret Access Keys or where to find other bucket details see the Wasabi Guide documentation.- Access Key ID (opens in a new tab): The Wasabi access key of the
deployment credentials
you want imgix to connect with. - Secret Access Key (opens in a new tab): The Wasabi secret key of the
deployment credentials
you want imgix to connect with. - Bucket Name: The name of the Wasabi bucket containing the assets you want imgix to connect to.
- Endpoint URL (opens in a new tab): The S3 endpoint URL used by your Wasabi bucket.
- Region: The region of your Wasabi bucket
- Path Prefix (optional): The folder prefix you want to resolve to (if it exists). The prefix is prepended to the asset path before resolving the asset in Wasabi. By default the asset path is
/
.
- Access Key ID (opens in a new tab): The Wasabi access key of the
-
Name the Subdomain you'd like to use as the base URL for your assets.
Note: The subdomain name you choose is unique to your Source and can't be re-used. If you're setting up a Source with a lot of customization (particularly a Custom Domain), choose the name you plan to use going forward.
- If you are editing an existing Source and the Video API is enabled, the imgix Video Subdomain field will be visible. This field automatically inherits the value from your imgix Image Subdomain and cannot be modified without changing the Image Subdomain.
- Click the Save button on Step #3 to queue your Source for deployment.
Wasabi Guide
We strongly recommend creating Wasabi access keys specifically for imgix to access your bucket with. All Wasabi credentials are stored using industry standard cryptographic best practices.
Advanced Settings
See the Advanced Source Settings for information about setting up custom domains, defaults, and cache TTL options.
Uploading
To upload images and videos directly to your cloud-storage-backed Wasabi Source, you will have to create a separate set of upload_credentials
.
imgix’s rendering service does not need Write
permissions to fetch assets; therefore, we highly recommend that you do not use the same credentials for your upload_credentials
and your deployment_credentials
.