domino logo
Latest (5.6)
  • Tech Ecosystem
  • Get Started
  • Domino Cloud
  • Code Assist
  • Collaborate
  • Projects
  • Work with Data
  • Workspaces
  • Environments
  • Executions
  • Deploy Models and Apps
  • Model Monitoring
  • Organizations
  • Security and Credentials
  • Notifications
  • Download the Audit Log
  • Data Planes
  • Search Your Domino Deployment
  • Domino CLI
  • Troubleshooting
  • Get Help
  • Send Feedback
domino logo
About Domino
Domino Data LabKnowledge BaseData Science BlogTraining
User Guide
>
Workspaces
>
Launch a Workspace

Launch a Workspace

Domino workspaces function as a server. You can use your preferred tools in a reproducible and customizable environment.

  1. In your project’s navigation pane, click Workspaces.

  2. Click + Create New Workspace.

  3. Enter a name for your workspace.

  4. Select an environment for your workspace. You can click one of Domino’s pre-defined environments, or create a custom environment. See Customize Environments to learn more about managing environments.

    By default, Domino uses the latest revision of your environment. To use another revision of the environment:

    1. In the Workspace Environments section, click Change to see the revisions for the environment.

      workspaces env revision 1

    2. Click the revision of the environment you want for your workspace. The version you selected displays in the Revision field.

      Note
      If you see the Not Recommended warning, then Domino recommends using the active revision set by the project owner.
  5. Select the integrated development environment (IDE) that you’ll use in your workspace (such as Jupyter). The selected environment determines the available IDEs. See Add Workspace IDEs to learn how to manage IDEs.

  6. Select a Hardware Tier.

    A hardware tier represents the compute hardware used for your run. It can be a virtual instance in a cloud services provider, or a physical machine running in your deployment’s on-premise data center.

    In a hybrid deployment, hardware tiers in the dropdown are grouped by data plane, such as GCP europe-central2 below. The Local data plane corresponds to running the workspace in the Domino control plane cluster.

    Launch a workspace and select a hardware tier
  7. If your administrator has enabled volume provisioning recommendations, you can select a Volume Size recommended by Domino based on your project size and previous usage, instead of the default volume size.

    Recommended volume size option in the Launch New Workspace window

    Note
    In a Git-based project, the first workspace you launch always uses the volume size configured in your project settings. Subsequent workspace launches receive volume provisioning recommendations.
  8. Click Next to attach a compute cluster or view additional details of the workspace (or click Launch to skip those options).

  9. If necessary, attach a compute cluster to your workspace. To learn more about clusters, see the following:

    • Spark on Domino

    • On-Demand Ray

    • On-Demand Dask

    • On-Demand Open MPI

      Attach a compute cluster

  10. Click Next to view additional details of the workspace (or click Launch to skip it).

    For workspaces in a Git-based project you can select a branch or commit ID.

    workspace branch or commit

    Domino shows you what data will be mounted in your workspace, based on the selected data plane.

    hybrid launch workspace2

    • In the example above, this workspace is running in the Local data plane.

    • We can see that the project’s dataset will not be available because it is only available in the Local data plane.

    • We can also see that the fsx-for-lustre EDV will be mounted because it has been added to this project and is available for the selected remote data plane.

    Tip
    If you want to use a data mount that is not available, note which data planes it is available in, then return to the first step in the modal to select a hardware tier in the corresponding data plane.
  11. Click Launch. A new tab opens and the workspace starts loading.

    workspaces 7

Important
Domino Data LabKnowledge BaseData Science BlogTraining
Copyright © 2022 Domino Data Lab. All rights reserved.