GitHub Codespaces Creation Failed

How to fix it

Try these in order — the most common fix is first.

1. 1. Check status and retry

   Copy steps
   1. Check githubstatus.com for active Codespaces incidents
   2. Delete the failed codespace from github.com/codespaces
   3. Create a new codespace
   Did this fix it? Yes No

2. 2. Find a stuck build

   Copy steps
   1. On the "Setting up your codespace" page click "View logs" (or click "Building codespace" in VS Code desktop)
   2. Look for a step that is hanging or asking for input
   3. Remove interactive prompts from build scripts
   Did this fix it? Yes No

3. 3. Speed up slow builds

   1. Configure prebuilds for the repository so the container is built ahead of time
   Did this fix it? Yes No

Symptoms

Creating a codespace fails, or the "Setting up your codespace" page never finishes.

Why it happens

• Temporary cloud infrastructure problem, such as failing to provision the virtual machine
• Container build takes longer than one hour and is cancelled
• A build script waits for interactive user input

This guide also covers

• codespace creation failed
• codespaces stuck on setting up your codespace
• github codespaces not working

The same problem in other apps

All storage, upload & download guides →

• Gitpod Classic JetBrains Gateway Not Working or Workspace Won't Start (Gitpod)

Other GitHub Codespaces errors

• Codespace Running in Recovery Mode: "This codespace is currently running in recovery mode due to a container error"
• Can't Create a Codespace: No Option to Create on the Repository
• GitHub Codespaces "503 Service Unavailable" Error
• Codespaces "Oh no, it looks like you are offline" and Other Connection Errors
• GitHub Codespaces Port Forwarding Not Working
• Codespace Out of Storage: How to Free Disk Space
• Codespaces Included Usage Used Up: Core Hours and Storage Quota
• Codespaces Prebuild Not Working: "Prebuild Ready" Label Missing