Create a workspace using the AWS Quickstart (Recommended)

Note

The AWS Quick Start for workspace deployment is only available for pay-as-you-go accounts.

This article explains how to create a Databricks workspace using the AWS Quick Start (CloudFormation template). Using the AWS Quick Start is the recommended approach for creating workspaces because it creates and configures the AWS resources for you.

If you want to manually create your workspace resources, see Manually create a workspace (existing Databricks accounts) or Create a workspace using the Account API. You can also use Terraform to automate workspace creation. See Create Databricks workspaces using Terraform.

Before you begin

If your AWS account already has several resources deployed in the AWS region you’re deploying this workspace to, this deployment could exceed your service quotas. This workspace quickstart requires an available VPC and NAT gateway.

If you don’t have the available resources, you can make room for this deployment by deleting unused resources or by requesting a service quota increase from AWS. To view your available quotas and request an increase, use the AWS Service Quotas console. For more information on AWS service quotas, see What is Service Quotas?.

Use AWS Quickstart to create a Databricks workspace

Use the following instructions to create a workspace with AWS Quick Start.

1. In your account console, click the Workspaces tab.

2. Click the Create workspace dropdown and select Quickstart (recommended).

3. On the Let’s set up your workspace page, enter the following:

   • A user-friendly Workspace name.

   • The AWS region you want to host your Databricks workspace in (typically, choose the region closest to your primary work location).

4. Click Start quickstart to take you to the AWS Quick Start form, which opens in a new tab.

5. On the Quick Start form, which is labeled Quick create stack:

   2. Select the I acknowledge that AWS CloudFormation might create IAM resources with custom names option.

   All other fields are prepopulated. You can rename these resources if you want, but you must adhere to the strict AWS naming rules for each resource or your deployment will fail.

6. Click Create stack to open the databricks-workspace-stack page, where you can see the workspace being created.

   While the workspace is being created, databricks-workspace-stack status shows as CREATE_IN_PROGRESS.

   

   When the workspace creation is complete, the status shows as CREATE_COMPLETE.

   

   If there are any issues, workspace creation automatically rolls back. Go to the Events tab for details. You can consult the Databricks Community forums for common errors and solutions.

7. When the databricks-workspace-stack status shows as CREATE_COMPLETE, return to the Workspaces dashboard in the Databricks account console to view your new workspace.

   Note

   You will also receive an email from noreply@databricks.com that includes a link to your new workspace.

8. Click next to the new workspace to launch your workspace.

9. Select your primary use case then click Finish.

Note

If you subscribed to Databricks through AWS Marketplace, Databricks usage takes 24 hours to appear in the AWS Billing & Cloud Management dashboard. Usage appears in the Databricks account console after one hour. To analyze usage, view the Usage dashboard in the account console.