Create a Colab Enterprise notebook by using the Google Cloud console

Learn how to create a Colab Enterprise notebook and run its codeon a default runtime by using the Google Cloud console.This page also describes how to rename, import, and delete a notebook.

Before you begin

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.create permission.Learn how to grant roles.
    Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI, Dataform, and Compute Engine APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enable permission.Learn how to grant roles.

    Enable the APIs

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.create permission.Learn how to grant roles.
    Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI, Dataform, and Compute Engine APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enable permission.Learn how to grant roles.

    Enable the APIs

Required roles

To get the permissions that you need to create a Colab Enterprise notebook and run the notebook's code on a runtime, ask your administrator to grant you the Colab Enterprise User (roles/aiplatform.colabEnterpriseUser) IAM role on the project. For more information about granting roles, seeManage access to projects, folders, and organizations.

You might also be able to get the required permissions throughcustom roles or otherpredefined roles.

One or more of the required roles includes thedataform.repositories.list permission. Users who are granted thedataform.repositories.list permission or theCode Creator (roles/dataform.codeCreator) role in a project can list the names of code assets in that project by using the Dataform API or the Dataform command-line interface (CLI). Non-administrators using BigQuery Studio can only see code assets that they created or that were shared with them.

Create a notebook

To create a Colab Enterprise notebookby using the Google Cloud console:

  1. In the Google Cloud console, go to the Colab EnterpriseMy notebooks page.

    Go to My notebooks

  2. In theRegion menu, select the region where you want to create your notebook.

  3. Click New notebook.

    Vertex AI creates and opens your notebook.

When you finish the tasks that are described in this document, you can avoid continued billing by deleting the resources that you created. For more information, seeClean up.

Run code in a default runtime

To run a Colab Enterprise notebook's code on the default runtime, do the following:

  1. In the Google Cloud console, go to the Colab EnterpriseMy notebooks page.

    Go to My notebooks

  2. In theRegion menu, select the region that contains your notebook.

  3. Click the notebook that you want to open.

  4. Hold the pointer over the code cell that you want to run, and then click the Run cell button.

  5. If this is your first time connecting to a runtime with end-user credentials enabled, aSign in dialog appears.

    The default runtime has end-user credentials enabled to make it easier torun code that interacts with Google Cloud.

    To grant Colab Enterprise access to your user credentials, complete the following steps:

    1. In theSign in dialog, click your user account.

    2. SelectSee, edit, configure, and delete your Google Cloud data... to grant Colab Enterprise access to your user credentials.

      The checkbox is next to a statement that says, "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account."

    3. ClickContinue.

After your runtime starts, Colab Enterprise connects to the runtime and runs the code in the cell.

Rename your notebook

To rename a Colab Enterprise notebook:

  1. In the Google Cloud console, go to the Colab EnterpriseMy notebooks page.

    Go to My notebooks

  2. In theRegion menu, select the region that contains your notebook.

  3. Next to the notebook that you want to rename, click theActions menu, and then selectRename.

  4. In theRename notebook dialog, change the name of the notebook, and then clickRename.

Import a notebook

To import a notebook into Colab Enterprise:

  1. In the Google Cloud console, go to the Colab EnterpriseMy notebooks page.

    Go to My notebooks

  2. In theRegion menu, select the region where you want to import your notebook.

  3. Click Import.

  4. In theImport notebooks dialog, select anImport source.

  5. If you selected:

    • Your computer, navigate to and select a notebook file to import.
    • Cloud Storage, navigate to and select a notebook in Cloud Storage.
    • URL, enter the URL of the notebook file to import.
    The notebook must be fewer than 20 MB.

  6. To add another notebook, click Add notebook.

  7. After you've added the notebooks that you want to import, clickImport.

    Colab Enterprise imports your notebook files.

Clean up

To avoid incurring charges to your Google Cloud account for the resources used on this page, follow these steps.

To avoid incurring charges to your Google Cloud account for the resourcesused in this tutorial, either delete the project that contains the resources,or keep the project and delete the individual resources.

Delete the project

    Caution: Deleting a project has the following effects:
    • Everything in the project is deleted. If you used an existing project for the tasks in this document, when you delete it, you also delete any other work you've done in the project.
    • Custom project IDs are lost. When you created this project, you might have created a custom project ID that you want to use in the future. To preserve the URLs that use the project ID, such as anappspot.com URL, delete selected resources inside the project instead of deleting the whole project.

    If you plan to explore multiple architectures, tutorials, or quickstarts, reusing projects can help you avoid exceeding project quota limits.

  1. In the Google Cloud console, go to theManage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then clickDelete.
  3. In the dialog, type the project ID, and then clickShut down to delete the project.

Delete your notebook

To delete a Colab Enterprise notebook:

  1. In the Google Cloud console, go to the Colab EnterpriseMy notebooks page.

    Go to My notebooks

  2. In theRegion menu, select the region that contains the notebook that you want to delete.

  3. Next to the notebook that you want to delete, click theActions menu, and then select Delete notebook.

  4. In theDelete notebook dialog, clickConfirm.

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-15 UTC.