Files
coder/docs/start/first-workspace.md
Edward Angert 101b62dc3e docs: convert alerts to use GitHub Flavored Markdown (GFM) (#16850)
followup to #16761 

thanks @lucasmelin !

+ thanks: @ethanndickson @Parkreiner @matifali @aqandrew 

- [x] update snippet
- [x] find/replace
- [x] spot-check


[preview](https://coder.com/docs/@16761-gfm-callouts/admin/templates/managing-templates/schedule)
(and others)

---------

Co-authored-by: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
Co-authored-by: M Atif Ali <atif@coder.com>
2025-03-10 16:58:20 -04:00

2.4 KiB

Creating your first coder workspace

A workspace is the environment that a developer works in. Developers in a team each work from their own workspace and can use multiple IDEs.

A developer creates a workspace from a shared template. This lets an entire team work in environments that are identically configured and provisioned with the same resources.

Before you begin

This guide will use the Docker template from the previous step to create and connect to a Coder workspace.

1. Create a workspace from your template through the GUI

You can create a workspace in the UI. Log in to your Coder instance, go to the Templates tab, find the template you need, and select Create Workspace.

Template Preview

In New workspace, fill in Name then scroll down to select Create Workspace.

Create Workspace

Coder starts your new workspace from your template.

After a few seconds, your workspace is ready to use.

Workspace is ready

2. Try out your new workspace

The Docker starter template lets you connect to your workspace in a few ways:

  • VS Code Desktop: Loads your workspace into VS Code Desktop installed on your local computer.
  • code-server: Opens browser-based VS Code with your workspace.
  • Terminal: Opens a browser-based terminal with a shell in the workspace's Docker instance.
  • JetBrains Gateway: Opens JetBrains IDEs via JetBrains Gateway.
  • SSH: Use SSH to log in to the workspace from your local machine. If you haven't already, you'll have to install Coder on your local machine to configure your SSH client.

Tip

You can edit the template to let developers connect to a workspace in a few more ways.

3. Modify your workspace settings

Developers can modify attributes of their workspace including update policy, scheduling, and parameters which define their development environment.

Once you're finished, you can stop your workspace.

Next Steps

  • Creating workspaces with the CLI
  • Creating workspaces with the API