mirror of
https://github.com/coder/coder.git
synced 2026-06-03 13:08:25 +00:00
Edward Angert
101b62dc3e
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>
68 lines
2.4 KiB
Markdown
68 lines
2.4 KiB
Markdown
# 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](../user-guides/workspace-access/index.md).
|
|
|
|
A developer creates a workspace from a
|
|
[shared template](../admin/templates/index.md). 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](../tutorials/template-from-scratch.md) 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**.
|
|
|
|
|
|
|
|
In **New workspace**, fill in **Name** then scroll down to select **Create
|
|
Workspace**.
|
|
|
|
|
|
|
|
Coder starts your new workspace from your template.
|
|
|
|
After a few seconds, your workspace is ready to use.
|
|
|
|
|
|
|
|
## 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](https://code.visualstudio.com/Download) installed on your
|
|
local computer.
|
|
- code-server: Opens
|
|
[browser-based VS Code](../user-guides/workspace-access/web-ides.md#code-server)
|
|
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](../admin/templates/extending-templates/web-ides.md).
|
|
|
|
## 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](../reference/cli/create.md)
|
|
- Creating workspaces with the [API](../reference/api/workspaces.md)
|