Skip to main content
Version: Beta 🚧

Creating a Workspace and Adding Users to the Workspace


Refer to Tecton Workspaces for an introduction to workspaces.

Creating a workspace

Step 1: Install the Tecton CLI

If you have not already done so, install the Tecton CLI on your local machine.

Step 2: Log in to your Tecton instance

Use tecton login to authenticate to your instance.

Step 3: Use tecton workspace to create a workspace

To create a development workspace named my_workspace:

$ tecton workspace create my_workspace

To create a live workspace named my_workspace, use the --live flag:

$ tecton workspace create my_workspace --live


Created workspace "my_workspace".
Switched to workspace "my_workspace".
You're now on a new, empty workspace. Workspaces isolate their state,
so if you run "tecton plan" Tecton will not see any existing state
for this configuration.

Applying features to a live workspace may incur additional costs as features are backfilled. Proceed with caution when applying changes to a live workspace.

Every Tecton cluster includes one live workspace, prod, that is used by default, unless another workspace is selected.

Adding users to a workspace

After a workspace is created, users can be added to the workspace using the Tecton Web UI or CLI.

For example, use the tecton access-control assign-role command to assign a workspace role to a principal.

If the user is already assigned that role across all workspaces, they are automatically assigned that role in the new workspace, and do not have to be assigned with the above command.

Selecting an existing workspace

After a workspace is created, the workspace will automatically be selected as the current workspace.

However, suppose your current workspace is my_workspace, and you want to select another workspace, my_workspace_2, as the current workspace. Use the tecton workspace select <workspace> command:

$ tecton workspace select my_workspace_2

Was this page helpful?

Happy React is loading...