Configure AWS storage (Legacy)


If your account is on the E2 version of the platform, instead see Manage storage configurations using the account console (E2). All new Databricks accounts and most existing accounts are now E2. If you are unsure which account type you have, contact your Databricks representative.

Databricks stores your account-wide assets, such as libraries, in an Amazon Web Services S3 bucket. This article walks you through the steps to configure your bucket to complete Databricks deployment.


You can configure AWS storage settings using the account console only when you initially set up your account. To change settings afterwards, contact

Step 1: Generate S3 bucket policy

  1. In the Databricks account console, click the AWS Storage tab.

    AWS storage tab
  2. In the S3 bucket in <region> field, enter the name of your S3 bucket. For help with creating an S3 bucket, see Create a Bucket in the AWS documentation.


    • The S3 bucket must be in the same region as the Databricks deployment.
    • Databricks recommends as a best practice that you use a Databricks-specific S3 bucket.
  3. Click Generate Policy.

  4. Copy the generated policy. It should be of the following form, where 414351767826 is the Databricks account ID and <s3-bucket-name> is the S3 bucket that you specified in the first screen:

      "Version": "2012-10-17",
      "Statement": [
          "Sid": "Grant Databricks Access",
          "Effect": "Allow",
          "Principal": {
            "AWS": "arn:aws:iam::414351767826:root"
          "Action": [
          "Resource": [

Step 2: Configure the S3 bucket

To configure the S3 bucket, you apply the bucket policy generated in the Databricks Account Console and optionally set up bucket versioning and S3 object-level logging (both highly recommended).

  1. In the AWS Console, go to the S3 service.
  2. Click the bucket name.

Apply the bucket policy

  1. Click the Permissions tab.

  2. Click the Bucket Policy button.

    Bucket policy button
  3. Paste the policy that you copied in Step 1 and click Save.

Step 3: Apply the change to your Databricks account

  1. In the Databricks account console, go to the AWS Storage tab.
  2. Click Apply Change.

Resolve validation failures

Bucket policy permissions can take a few minutes to propagate. You should retry if validation fails due to permissions.