Launch a Workspace

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

Basic configuration

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

  2. Click + Create New Workspace.

  3. Enter a name for your Workspace.

Select a compute environment

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.

    Environment revisions

  2. Click the revision of the Environment you want for your Workspace. The version you selected displays in the Revision field.
    If you see the Not Recommended warning, then Domino recommends using the active revision set by the Project owner.

Note
 Restricted Projects may limit your choice of Environments.

Select a Workspace IDE

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.

Select a Volume Size

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.

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.

Select a hardware tier

Click next and select a Hardware tier.

A hardware tier represents the compute hardware — CPU, memory, and other resources like GPUs — 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. Workspace scheduling requires a server with adequate free resources; otherwise, the Workspace queues until resources free up or a new server is available. Selecting a smaller hardware tier can speed up provisioning. Opt for the smallest tier that fulfills your task’s needs.

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

Mount data

Domino shows you what data is available to be mounted to your Workspace, based on the selected data plane.

To ensure faster startup times, only select the data that you need.

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.

  • When a Workspace, Job, or other execution starts, all project files — including from the main DFS repo, main git repo (if applicable), and any imported git repos and Domino Projects — must be transferred over the network to the Persistent Volume for the execution. Large file counts or very large individual files can significantly delay the startup process. In contrast, files in a Domino Dataset or External Data Volume do not require network transfer. If your executions spend considerable time preparing files during startup, assess if files in the main DFS repo, main git repo (if applicable), and any imported git repos and Domino Projects must be in that repo. If not, you can relocate these files to a Domino Dataset or External Data Volume to expedite startup.

Attach compute clusters

  1. Click Next to attach a compute cluster or view additional details of the Workspace (or click Launch to skip those options).

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

Launch the Workspace

  1. Click Launch.

  2. A new tab opens and the Workspace starts loading.

Important

  • If you cannot access a newly launched Workspace, check your browser’s configuration settings. Your browser must allow pop-up windows from Domino.

  • By default, Domino limits each user to four Workspaces per Project. To change this setting, contact your Domino administrator.

Next steps