Create a Workspace

You need the 'workspace.create' permission to create workspaces.

1. 1

   Navigate to a Project from the Projects page
2. 2

   Click the 'New Workspace' button
3. 3

   Fill in the workspace details:
4. 4

   Click 'Create'
5. 5

   The workspace appears in the workspaces grid

• Leave State Bucket empty for local state (simple setups and testing)
• Enter a bucket path for team environments where state should be shared:
• AWS S3: s3://my-bucket/state/workspace-name
• Azure Blob: azurerm://my-storage/container/workspace-name
• GCP GCS: gcs://my-bucket/state/workspace-name

• Use environment names: dev, staging, prod
• Use region names for multi-region setups: us-east-1, eu-west-2
• Keep names lowercase with hyphens

• Click the workspace card to open the Workspace Editor
• The editor provides the full IDE, terminal, and AI chat interface