Databricks CLI

The Databricks CLI is required for every template on this site, which includes CLI commands for scaffolding and deployment. Install and authenticate before you begin.

Command-line tool for workspace operations, app deployment, and automation. This page covers installation and authentication. Product-specific commands (databricks apps, databricks postgres, databricks serving-endpoints) are covered in each product's docs.

For the full command reference, see the official CLI docs.

Install or upgrade

DevHub templates assume version 0.296+.

macOS / Linux

brew tap databricks/tap
brew install databricks

brew update && brew upgrade databricks

Windows

winget install Databricks.DatabricksCLI

winget upgrade Databricks.DatabricksCLI

curl (all platforms)

curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh

On Windows, use WSL. If /usr/local/bin is not writable, rerun with sudo. Re-running the script also upgrades an existing install.

Authenticate

Browser-based OAuth is the default for local use:

databricks auth login

Prompts for a profile name (defaults to DEFAULT), then opens a browser to authenticate and select a workspace. Credentials save to ~/.databrickscfg.

To target a specific workspace and name the profile:

databricks auth login --host <workspace-url> --profile <PROFILE>

Pass --profile <PROFILE> on subsequent commands when using named profiles.

List saved profiles:

databricks auth profiles

Name              Host                                             Valid
DEFAULT           https://adb-1234567890.12.azuredatabricks.net    YES
my-prod-workspace https://mycompany.cloud.databricks.com           YES

Name is the profile label, Host is the workspace URL, and Valid is the result of a live authentication check against the workspace. NO means the check failed; re-run databricks auth login --profile <NAME> to re-authenticate.

For CI/CD, use OAuth client credentials or token-based auth (no browser step). See CLI authentication.

Product commands

Product-specific CLI commands are covered alongside each product:

• databricks apps: Apps development
• databricks postgres: Lakebase development
• databricks serving-endpoints: AI Gateway

Agent skills

Install agent skills to give AI coding assistants Databricks platform knowledge:

databricks experimental aitools install

By default, skills install globally. Pass --project to install into the current project directory instead. See the agent skills page for all options.

Where to next

With the CLI installed and authenticated, pick a template to start building.