Skip to main content
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 trait. Some common ways to implement Workspaces are:
  • Using a single Workspace for an entire Organization, with all development and production pipelines hosted together.
  • Using a Workspace per team. For example, you might have a Workspace for your Data Science team and a separate Workspace for your Data Engineer team, with each team’s Workspace hosting both production and development pipelines.
  • Using a Workspace per project. For example, you might have a Workspace called “Sales Analytics Project” that hosts both production and development pipelines.
This document explains how to configure Workspace details. To manage Workspace users, see Manage Workspace users.
A new Astro UI is hereAstronomer has redesigned the Astro UI. Try the new experience and switch your instructions using the New Astro UI and Legacy UI tabs on this page. Your selection is remembered across the docs.

​
Create a Workspace

To create a Workspace, you must have an Organization-level role.
  1. In the Astro UI, go to Settings > Workspaces.
  2. Click + New Workspace.
During this initial setup, you can configure the Workspace’s name and description. You can update all other Workspace settings later from the Workspace’s settings.
The new Astro UI doesn’t have a separate Workspace view. To scope to a specific Workspace, use the Workspace dropdown in the Deployments, DAGs, and Environment sections. To manage a Workspace’s settings, go to Settings > Workspaces, then select the Workspace.

​
Update general Workspace settings

  1. In the Astro UI, go to Settings > Workspaces, then select your Workspace.
  2. In the General section, click Edit, update the Name and Description as needed, then click Save.
  3. To set the CI/CD enforcement default, toggle CI/CD Enforcement in the Deployment Defaults section. This determines whether new Deployments in the Workspace enforce CI/CD deploys by default, and can be overridden at the Deployment level. See Enforce CI/CD deploys.

​
Configure Otto investigation guidance

Otto investigation guidance is custom text you provide to tailor Otto investigations to your environment. For example, you can instruct Otto to treat tasks that begin with validate as non-blocking data quality tests, or to interpret a specific log pattern in a particular way. Guidance set at the Workspace level applies to every Deployment in the Workspace. Individual Deployments can override it. See Configure Otto investigation guidance for a Deployment.
  1. In the Astro UI, go to Settings > Workspaces, then select your Workspace.
  2. In the AI Agents section, click the Edit icon next to Otto Investigation Guidance.
  3. Enter up to 10,000 characters of markdown guidance, then save your changes.

​
Delete a Workspace

  1. In the Astro UI, go to Settings > Workspaces, then select your Workspace.
  2. Scroll to the Danger Zone section, then click Delete Workspace. This option isn’t available when there are active Deployments in the Workspace.
  3. In the confirmation dialog, enter delete and then click Yes, Continue.