Manually create a workspace (new Databricks accounts)

Note

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.

You can also create workspaces using the Account API or Terraform.

Create a workspace with custom AWS configurations

1. Go to the account console and click the Workspaces icon.

2. Click Create Workspace, then Manual.

3. In the Workspace name field, enter a human-readable name for this workspace. It can contain spaces.

4. In the Region field, select an AWS region for your workspace’s network and clusters. Click Next.

5. 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.

6. Click Next.

7. 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).

8. (Optional) Set up any Advanced configurations. See Advanced configurations.

9. Click Next.

10. Review your workspace details and click Create workspace.

Advanced configurations

The following configurations are optional when creating a new workspace.

Select a metastore

Confirm the metastore assignment for your workspace.

Create workspace in your own VPC

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.

Important

If you are using a customer-managed VPC, ensure your IAM role uses an access policy that supports customer-managed VPCs.

Enable PrivateLink

To enable PrivateLink, select or add a private access setting under Private Link.

To enable PrivateLink, you must also have created the correct regional VPC endpoints, registered them, and referenced them from your network configuration. For more guidance, see Enable AWS PrivateLink.

Add encryption key for managed services

You can add an encryption key to your workspace deployment that would encrypt notebooks, secrets, and Databricks SQL query data in the control plane. You can also rotate this key after your workspace is deployed.

View workspace status

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.

Log into a workspace

1. Go to the account console and click the Workspaces icon.

2. On the row with your workspace, click Open.

3. To log in as a workspace administrator, log in with your account owner or account administrator email address and password. If you configured single-sign on (SSO), click the Single Sign On button.