Manage Workspaces

This page explains how you can view, stop, resume, and delete your Workspaces.

View Workspaces

View Workspaces in a Project

You can navigate to a specific Workspace in your Project:

  • To view the Workspaces that you created, go to Workspaces > My Workspaces.

  • To view all Workspaces that have been created by you or other users, go to Workspaces > All Workspaces.

  • To view deleted Workspaces, go to Workspaces > Deleted.

View Workspaces in all your Projects

From the top navigation pane, click Develop > Workspaces to navigate to the global Workspaces page.

Here you’ll see all Workspaces, their status, and what project they are tied to.

Stop a Workspace

You can stop a Workspace and resume it later. Frequently stopping and resuming a Workspace session is a good way to manage compute costs. However, storage costs (for example, Amazon EBS) will continue to incur.

Important

Stopping a Workspace does not automatically sync your work to Domino. See Sync Changes to sync your work.

  1. You can stop a Workspace from either within your Project or from the global Workspaces page:

    • In your Project, go to Workspaces > My Workspaces, then click Stop.

    • Navigate to Develop > Workspaces in the top navigation pane, click the row menu on the right of your Workspace, then click Stop Workspace.

  2. A window opens with additional information about stopping the Workspace. Click Stop My Workspace.

When you stop your Workspace, the following settings persist and will be available to you when you resume your workspace session:

  • Files saved in the /mnt directory

The following settings will not persist and will reload when you resume your stopped Workspace:

  • Files outside the /mnt directory, including installed packages

  • Objects in memory

  • Datasets

If you’re using a Git-based project and someone updates or deletes the credentials to the Git repository while your workspace session is stopped, the credentials will be updated when you resume your Workspace.

Resume a Workspace

You can restart a Workspace that you stopped previously. Saved changes are available and can be synced.

  1. You can start a Workspace from either within your Project or from the global Workspaces page:

    • In your Project, go to Workspaces > My Workspaces. Go to the stopped Workspace, then click Start.

    • Navigate to Develop > Workspaces in the top navigation pane, click the row menu on the right of your Workspace, then click Start Workspace.

  2. The Workspace opens in a new tab.

Note
 When a Workspace is restarted in a restricted project, Domino uses the current restricted revision of the environment. This revision may be different from the revision that was used to start the Workspace previously.

Delete a Workspace

Warning

  • Ensure that all your work is synced to Domino before deleting a Workspace. Failure to do so will result in unrecoverable work.

  • When you delete a Workspace, all its snapshots are also deleted and cannot be recovered.

You can delete a Workspace if it’s no longer needed.

You must stop the Workspace before it can be deleted. The delete option will be inactive (appear greyed out) until all persistent volumes are detached.

  1. You can start a Workspace from either within your Project or from the global Workspaces page:

    • In your Project, go to Workspaces > My Workspaces. Go to the stopped Workspace, then click the red trash icon to delete the Workspace.

    • Navigate to Develop > Workspaces in the top navigation pane, click the row menu on the right of your stopped Workspace, then click Delete.

  2. Click Delete to confirm that you’d like to delete the Workspace.

Auto-delete Workspaces

If your administrator has enabled the Workspace auto-deletion feature, Domino automatically deletes Workspaces that have been stopped for 10 days plus a 30-day grace period. Your administrator can modify these periods.

Domino notifies you (in the application and through email) before your Workspace is deleted.

  1. The first notification indicates that your Workspace has been marked for deletion and the grace period has started.

  2. Halfway through the grace period, Domino notifies you again and indicates whether the Workspace has uncommitted changes.

  3. Two days before auto-deletion, Domino notifies you again, including whether the Workspace has uncommitted changes.

  4. Finally, Domino notifies you when the Workspace has been deleted.

To remove a Workspace from the auto-deletion schedule, restart it. The auto-delete period restarts the next time the Workspace is stopped.

Next steps