What you get
When you create an instance, Codespace automatically provisions:- A Kubernetes namespace
- A PostgreSQL database
- A Coder Helm release
- A TLS certificate
- A DNS record at
your-subdomain.codespace.sh
Create an instance
- From the dashboard, click New Instance
- Enter an instance name — a friendly name like “My Team” or “Engineering”
- Choose a subdomain — this becomes your domain:
subdomain.codespace.sh - Click Create Instance
Subdomain rules
- Lowercase letters, numbers, and hyphens only
- Must start and end with a letter or number
- Cannot be changed after creation
Track provisioning
After creating your instance, you’re taken to the detail page where you can watch provisioning progress. The Events tab shows each step:- Namespace creation
- Database setup
- Coder Helm release
- TLS and DNS configuration
The dashboard polls for updates automatically. You don’t need to refresh the page.
When it’s ready
Once the status changes to Running:- Click Open Coder to access your Coder dashboard
- Copy the admin credentials from the credentials card to sign in
- Start creating workspaces from templates
If provisioning fails, see Retry failed provisioning for troubleshooting.