| --- | |
| description: The tofu workspace select command is used to choose a workspace. | |
| --- | |
| # Command: workspace select | |
| The `tofu workspace select` command is used to choose a different | |
| workspace to use for further operations. | |
| ## Usage | |
| Usage: `tofu workspace select NAME [DIR]` | |
| This command will select another workspace. The named workspace must already | |
| exist. | |
| :::note | |
| Use of variables in [module sources](../../../language/modules/sources.mdx#support-for-variable-and-local-evaluation), | |
| [backend configuration](../../../language/settings/backends/configuration.mdx#variables-and-locals), | |
| or [encryption block](../../../language/state/encryption.mdx#configuration) | |
| requires [assigning values to root module variables](../../../language/values/variables.mdx#assigning-values-to-root-module-variables) | |
| when running `tofu workspace select`. | |
| ::: | |
| The supported flags are: | |
| * `-or-create` - If the workspace that is being selected does not exist, create it. Default is `false`. | |
| * `-var 'NAME=VALUE'` - Sets a value for a single | |
| [input variable](../../../language/values/variables.mdx) declared in the | |
| root module of the configuration. Use this option multiple times to set | |
| more than one variable. Refer to | |
| [Input Variables on the Command Line](../plan.mdx#input-variables-on-the-command-line) for more information. | |
| * `-var-file=FILENAME` - Sets values for potentially many | |
| [input variables](../../../language/values/variables.mdx) declared in the | |
| root module of the configuration, using definitions from a | |
| ["tfvars" file](../../../language/values/variables.mdx#variable-definitions-tfvars-files). | |
| Use this option multiple times to include values from more than one file. | |
| * `-json` - Enables the [machine readable JSON UI](../../../internals/machine-readable-ui.mdx) output. | |
| * `-json-into=out.json` - Produces the same output as -json, but redirected to a file. This allows | |
| for simultaneous capture of both human readable and machine readable logs. | |
| There are several other ways to set values for input variables in the root | |
| module, aside from the `-var` and `-var-file` options. Refer to | |
| [Assigning Values to Root Module Variables](../../../language/values/variables.mdx#assigning-values-to-root-module-variables) for more information. | |
| ## Example | |
| ``` | |
| $ tofu workspace list | |
| default | |
| * development | |
| jsmith-test | |
| $ tofu workspace select default | |
| Switched to workspace "default". | |
| ``` |