Create a custom Databricks app

Create a custom Databricks app using your own code. Start by naming the app, then upload your code and artifacts to the workspace. Azure Databricks creates the app but leaves deployment up to you, so you have full control over the app’s setup and configuration.

Create the app

UI

To create a custom app in the Azure Databricks UI, do the following:

1. In your Databricks workspace, click the app switcher and select Databricks Apps.

2. Click + Create app.

3. Click Create a custom app.

4. Enter a name for your app and an optional description.

   Note

   • App names must be unique within the workspace and can only contain lowercase letters, numbers, and hyphens. Names must start and end with a letter or number.
   • Don't include sensitive information in app names.
   • You can't change the app name after you create it.
   • App names and deployment history are visible to all workspace users.

5. Click Next: Configure Git to configure a Git repository for your app. See Deploy from a Git repository.

6. Click Next: Configure (or Create app to skip advanced configuration).

   Configure the following optional settings:

   • App resources: Add resources that the app service principal will access on behalf of the app. See Add resources to a Databricks app.
   • User authorization: Add API scopes so the app can access resources on behalf of the user. See Configure authorization in a Databricks app.
   • App Telemetry (Beta): Configure a Unity Catalog catalog and schema to collect traces, logs, and metrics for your app. See Configure telemetry for Databricks Apps.
   • Compute: Configure the CPU and memory for your app. See Configure compute resources for a Databricks app.

7. Click Create app.

CLI

To create a custom app with the Databricks CLI, run databricks apps create with a name and an optional description. App names follow the same rules as in the UI: they can only contain lowercase letters, numbers, and hyphens, and must start and end with a letter or number.

databricks apps create my-app --description "My custom app"

The command waits until the app's compute starts. To set the instance size, add --compute-size. See Configure compute resources for a Databricks app. To add resources after you create the app, see Configure resources for your app.

Azure Databricks creates the app but doesn't deploy it automatically. Because you’re using custom code, you must upload your code and artifacts and then deploy the app manually.

The app details page shows the following:

• The status of app creation.
• Instructions for syncing code and artifacts from your local environment to the Azure Databricks workspace, and how to deploy the app.

Azure Databricks generates the app URL automatically based on your app name and workspace ID. You can't change the URL after you create the app. If you need a different URL, create a new app with a different name. For more information, see App URL.

To learn how to update app code, see Develop Databricks apps.