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

  1. 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.

Select a Workspace IDE

  1. 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 hardware tier

  1. 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.

    Select a hardware tier

  2. 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.

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 Spark compute cluster to your Workspace. To learn more about Spark clusters, see Spark on Domino.

    Attach a compute cluster

  3. Optional: Configure Datasets or external data volumes in the Data section of the modal.

    Data configuration

  4. Click Next if you want to review the Datasets and external data volumes in your Project. Otherwise, click Launch.

Additional configuration

Domino shows you what data will be mounted in your Workspace.

Tip
 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.

Launch the Workspace

  1. Click Launch. A new tab opens and the Workspace starts loading.

    Workspace startup

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.