DevZero Logo
DevZero

Creating a Workspace

Step-by-step guide to creating a Workspace on DevZero.

Creating a Workspace on DevZero

Workspaces are custom environments built dynamically from recipes. A recipe is a pre-defined configuration file that specifies the tools, dependencies, and environment setup for your Workspace. This guide walks you through creating a Workspace using either a custom recipe or a template recipe provided by DevZero.

From your DevZero Console, go to the Workspaces section and select Launch New Workspace.

Navigate to Workspaces

Configure Workspace Settings

Configure the following settings for your Workspace:

  • Workspace Name: Provide a name for your Workspace.
  • Workspace Region: Define a region to launch your Workspace. Defaults to your preferred region as defined in the settings.
  • Attach Storage Volume: Select a shared storage volume to attach to your Workspace. Volumes must already exist in the selected region.

Configure Workspace Settings

The Attach Storage Volume option is available only for Pro users.

Choose a Recipe

Every Workspace requires a recipe. You can:

  • Use Recipe Library: Select a recipe youโ€™ve created or customized.
  • Use Starter Templates: Choose from pre-configured templates provided by DevZero.

If you donโ€™t have a recipe yet, create one here.

Once configured, click on Launch. This will initialize the environment based on your chosen recipe.

Choose a Recipe

Launch the Workspace

Your workspace will start building and you can monitor the logs in real-time. Once it has been successfully built, you can now connect to it. Once your Workspace is created, it will appear in the Workspaces list.

Launch Workspace

Access and Connect to the Workspace

After launching, you can access your Workspace via:

  • DevZero CLI: Use the dz workspace connect command to SSH into the Workspace.
  • Integrated Development Environments (IDEs): Connect directly using IDEs like VSCode or JetBrains Gateway.
  • Web-based SSH: Access the Workspace via the DevZero Console.

For more details on accessing a Workspace, see Accessing the Workspace.

Connect to Workspace

Make sure the DevZero CLI is installed to connect to your Workspace.

On this page