These instructions apply to accounts created after November 8, 2023. If your Databricks account was created before November 8, 2023, see Manually create a workspace (existing Databricks accounts).
This article describes how to manually create a workspace using the account console and custom AWS configurations. You can use this process if you want to create your own AWS resources or need to deploy a workspace in your own VPC. If you don’t need to create custom configurations for your deployment, Databricks recommends you create workspaces using the AWS Quick Start template.
Go to the account console and click the Workspaces icon.
Click Create Workspace, then Manual.
In the Workspace name field, enter a human-readable name for this workspace. It can contain spaces.
In the Region field, select an AWS region for your workspace’s network and clusters. Click Next.
In the Storage configuration field, select or create a storage configuration. If you create a new storage credential, follow the steps listed in the UI.
In the Credential configuration field, select or create the credential configuration you’ll use for this workspace. To create a new credential configuration, follow the steps listed in the UI (also available in Create an IAM role for workspace deployment).
(Optional) Set up any Advanced configurations. See Advanced configurations.
Review your workspace details and click Create workspace.
The following configurations are optional when creating a new workspace.
To create the workspace in your own VPC, select or add a Network configuration. For instructions on configuring your own VPC, see Configure a customer-managed VPC.
If you are using a customer-managed VPC, ensure your IAM role uses an access policy that supports customer-managed VPCs.
After you create a workspace, you can view its status on the Workspaces page.
Provisioning: In progress. Wait a few minutes and refresh the page.
Running: Successful workspace deployment.
Failed: Failed deployment.
Banned: Contact your Databricks representative.
Cancelling: In the process of cancellation.
If the status for your new workspace is Failed, click the workspace to view a detailed error message. You can make updates to the configuration and try to deploy the workspace again. See Troubleshooting creating workspaces.