Skip to main content
Version: Latest

Manage workspaces

Check your docs version

These docs are for the new Anyscale design. If you started using Anyscale before April 2024, use Version 1.0.0 of the docs. If you're transitioning to Anyscale Preview, see the guide for how to migrate.

Create a workspace

You can create a workspace from a template on the home page. These templates include a code sample and the suggested compute and environment configurations by Anyscale. You can customize these examples with your own code and settings.

Workspace template card

To create a blank workspace, go to the Workspaces page and select Create and Custom blank workspace.

Create blank workspace

Creating a blank workspace gives you the option to configure all the workspace settings prior to starting.

Custom workspace settings

Idle termination

Anyscale terminates a workspace after a period of inactivity by default. The following actions count as activities:

  • A running Ray Job is an ongoing activity for its duration.
  • Completing or canceling a command submitted through any terminal (web terminal, VS Code). A submitted command does not count as an activity until it finishes.
  • Making a change to the filesystem of an Anyscale Workspace.
  • A change made by code running in the workspace only counts as activity if it causes a new workspace snapshot. In other words, the change affects a file tracked by Git.

To disable automatic idle termination, select Auto termination from the dropdown next to Terminate in a workspace. Here, you can edit idle termination and maximum uptime settings.

Running a notebook doesn't automatically count as activity. However, when running ray.init() inside a notebook or attaching a Ray Driver, the workspace remains active unless it's explicitly stopped with ray.shutdown() or exceeds the maximum uptime configured.

Update existing workspaces


The Dependencies tab within a workspace offers the ability to either change the base image or manage the pip packages installed in it.

Anyscale automatically tracks pip packages installed on a workspace when running pip install PACKAGE_NAME on any terminal. For more information, check Dependency Management.

Cluster panel

Compute configuration

Click on the workspace status in the right top corner to open the cluster panel. In this panel, you can change the compute configuration of the workspace and monitor the status of the cluster.

Cluster panel

Duplicate a workspace

Duplicating a workspace creates a new workspace from the current state of an existing one. That includes:

  • Code
  • Compute config
  • Dependencies

However, cluster storage isn't duplicated.

Duplicate workspace