Skip to main content
This guide walks you through the complete flow from sign-up to a running workspace.

​
1. Create your account

Codespace is in private beta. You need an invite code to sign up.
  1. Go to codespace.sh/signup
  2. Enter your invite code, name, email, and a password (minimum 12 characters)
  3. Check your email for a verification link and click it
If you don’t receive the verification email, check your spam folder. You can also resend it from the login page.

​
2. Create your first instance

  1. From the dashboard, click New Instance
  2. Enter a name for your instance (e.g., “My Team”)
  3. Choose a subdomain — this becomes your instance URL: your-subdomain.codespace.sh
  4. Click Create Instance

​
3. Wait for provisioning

Codespace provisions a dedicated Coder deployment for you. This typically takes 2–5 minutes. You can watch the progress on the instance detail page — the Events tab shows each provisioning step in real time.
Your instance transitions through these states: Pending → Provisioning → Running. The dashboard auto-refreshes every few seconds.

​
4. Open your Coder dashboard

Once your instance shows Running:
  1. Click Open Coder to go to your Coder dashboard at your-subdomain.codespace.sh
  2. Use the admin credentials shown on the instance detail page to sign in
  3. You’re now in Coder — create your first workspace from the available templates

​
5. Invite your team (optional)

  1. Go to your instance’s Settings page
  2. Under Team Members, enter an email and click Invite
  3. Your teammate receives an email with a link to join

​
What’s next?

Instance dashboard

Learn what’s on the instance detail page.

Manage workspaces

Create, start, stop, and delete workspaces.

Connect GitHub

Set up GitHub authentication for your instance.

Set up 2FA

Secure your account with two-factor authentication.