If your instance fails to provision, you can retry from the instance detail page.
Check the events
Before retrying, review the Events tab on the instance detail page. It shows which provisioning step failed and often includes error details.
Common failure causes:
| Cause | What to do |
|---|
| Temporary infrastructure issue | Retry — usually succeeds on the second attempt |
| Resource quota exceeded | Check your subscription plan |
| Network timeout | Retry after a few minutes |
Retry provisioning
- Go to the instance detail page
- In the quick actions sidebar, click Retry Provisioning
- Codespace re-runs the full provisioning process
The instance returns to Provisioning state and you can track progress in the Events tab.
Force reprovision (running instances)
If your instance is already running but you need to re-apply configuration (for example, after changing GitHub integration or login provider settings):
- Go to the instance detail page
- Click Force Reprovision in the sidebar
- Codespace re-applies the Terraform configuration
Force reprovisioning briefly interrupts access to your instance while configuration is re-applied.
Still failing?
If provisioning continues to fail after retrying, the Events tab provides detailed error information. Contact support with the event details for assistance.