Skip to main content

Manage Workspaces on Astro

Workspaces are collections of Deployments that can be accessed by a specific group of users. You can use Workspaces to group Deployments that share a business use case or environment trait. For example, you might create one Workspace that stores all of your production pipelines and another Workspace that stores all of your development pipelines.

Create a Workspace


To create a Workspace, you must have an Organization-level role.

To create a Workspace, click the Add Workspace button from the Overview tab.

Add Workspace button in the Cloud UI

During this initial setup, you can configure a Workspace's name and description. All further Workspace configuration is completed in the Workspace view.

Workspace View

To to enter your Workspace, click the Workspace in the Overview tab. When you click into a Workspace and see a list of that Workspace's Deployments, you are in the Workspace view of the Cloud UI. The Workspace view contains several pages for managing your Workspace which are accessible from a sidebar on the left of the screen:

  • Home: View the status of your Deployments and select recently accessed Deployments.
  • Deployments: Create new Deployments and see key metrics about existing Deployments in the Workspace. For more information, see Create a Deployment.
  • DAGs: View metrics about individual DAGs across your Workspace. For more information, see Deployment metrics.
  • Workspace Settings: Update Workspace details, including Workspace user permissions, the Workspace name, and the Workspace description.

Manage Workspace Users

As a Workspace Admin, you can add or remove users from your Workspace at any time. Before adding a user, make sure that the user is an existing member of your Organization. If the user is not, invite them to Astro before following the steps below.

  1. In the Workspace view, go to the Access page.
  2. Click Add member.
  3. Specify the user's email and role within the Workspace. For more information about Workspace roles and permissions, see User permissions.

After adding the user, the user will see the Workspace listed on the Overview page of the Cloud UI. They will also appear as an active Workspace member in the Access tab. For more information about inviting users to Astronomer, see Add a user.

Update or Remove a Workspace User

  1. In the Cloud UI, select a Workspace.

  2. Click Workspace Settings.

  3. Click Edit next to the user name:

    Edit Workspace user button

  4. Edit the user's name or role and then click Update Member.

Update Workspace details

  1. In the Cloud UI, select a Workspace.
  2. Click Workspace Settings and then click the Details tab.
  3. Click Edit Details, update the Workspace name or description, and then click Update.

Delete a Workspace

  1. In the Cloud UI, select a Workspace.

  2. Click Workspace Settings.

  3. Click the option menu at the top of the page and select Delete Workspace. This option isn't available when there are active Deployments in the Workspace.

    Delete Workspace button

  4. In the confirmation dialog, enter delete and then click Yes, Continue.