How to fix Error: Timeout while waiting for state in Terraform

What this error means

Terraform manages resources by monitoring their state as they transition from one status to another. When creating, updating, or deleting resources, Terraform polls the cloud provider's API to check if the resource has reached the desired state (e.g., "running" for an EC2 instance, "available" for a database). The timeout error occurs when Terraform has been polling for the configured duration (default varies by resource, typically 5-30 minutes) without the resource reaching its desired state. This doesn't necessarily mean the operation failed—it may still be in progress, but exceeded Terraform's patience.

Typical symptoms

• Terraform apply fails with "timeout while waiting for state" message
• Error includes the expected state (e.g., "waiting for state to become 'running'") and the actual timeout duration
• Resource may or may not exist in your cloud provider
• Problem occurs consistently when provisioning specific resource types
• Large batch operations (30+ instances) more likely to timeout
• Terraform becomes unresponsive during the polling phase

Common causes

1. Cloud provider is experiencing high load or has insufficient capacity in your availability zone
2. Resource provisioning genuinely takes longer than Terraform's default timeout
3. Network latency or API rate limiting slowing down state checks
4. Misconfigured resource settings causing provisioning to hang
5. Cloud provider service degradation or maintenance
6. Resource dependencies not properly specified causing ordering issues
7. Insufficient quotas or limits reached in your cloud account

How to fix "Error: Timeout while waiting for state"

Error: timeout while waiting for state to become 'running' (timeout: 5m0s)
  on main.tf line 12, in resource "aws_instance" "example":
  12:   resource "aws_instance" "example" {

resource "aws_instance" "example" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t2.micro"

  timeouts {
    create = "30m"
    delete = "10m"
    update = "20m"
  }
}

resource "aws_db_instance" "example" {
  allocated_storage = 20
  engine            = "mysql"
  
  timeouts {
    create = "60m"
    update = "80m"
    delete = "40m"
  }
}

TF_LOG=DEBUG terraform apply

resource "aws_security_group" "example" {
  name = "example"
}

resource "aws_instance" "example" {
  ami                    = "ami-0c55b159cbfafe1f0"
  instance_type         = "t2.micro"
  vpc_security_group_ids = [aws_security_group.example.id]  # Explicit dependency
}

# AWS - Check service quotas
aws service-quotas list-service-quotas --service-code ec2 --region us-east-1

# Check current usage
aws ec2 describe-account-attributes --region us-east-1

# AWS - Check available capacity
aws ec2 describe-spot-price-history \
  --instance-types t2.micro \
  --region us-east-1 \
  --start-time $(date -u +%Y-%m-%dT%H:%M:%S) \
  --product-descriptions "Linux/UNIX"

resource "aws_instance" "example" {
  ami               = "ami-0c55b159cbfafe1f0"
  instance_type     = "t2.small"  # Try different type
  availability_zone = "us-east-1b"  # Try different AZ
}

# First, check Terraform's state
terraform state list
terraform state show aws_instance.example

# If the resource exists but is still provisioning, just retry apply
terraform apply

# If you need to force recreation
terraform taint aws_instance.example
terraform apply

Advanced notes

resource "aws_autoscaling_group" "example" {
  health_check_grace_period = 300  # Give instances 5 minutes to start
  health_check_type         = "ELB"
}

Frequently asked questions

What does "Error: Timeout while waiting for state" mean?

Terraform manages resources by monitoring their state as they transition from one status to another. , "running" for an EC2 instance, "available" for a database). The timeout error occurs when Terraform has been polling for the configured duration (default varies by resource, typically 5-30 minutes) without the resource reaching its desired state.

How do I fix "Error: Timeout while waiting for state"?

The "Timeout while waiting for state" error occurs when Terraform cannot detect that a resource has reached its desired state within the configured timeout period. This typically indicates either a slow-running operation, resource constraints in your cloud provider, or network connectivity issues.

What causes "Error: Timeout while waiting for state"?

Cloud provider is experiencing high load or has insufficient capacity in your availability zone Resource provisioning genuinely takes longer than Terraform's default timeout Network latency or API rate limiting slowing down state checks

Is the "Error: Timeout while waiting for state" error serious?

It is a medium-severity error — more of a blocker than a risk. The steps above resolve it.

Related errors

• Error: Error generating private key

  How to fix 'Error generating private key' in Terraform

  MEDIUM

• timeout while waiting for state to become ready

  Timeout while waiting for state to become ready in Terraform

  MEDIUM

• Error: Error parsing certificate

  How to fix "Error parsing certificate" in Terraform

  HIGH

• Error: Error parsing timestamp

  How to fix "Error parsing timestamp" in Terraform

  HIGH

• context deadline exceeded

  Context deadline exceeded in Terraform

  HIGH

• resource is tainted, so must be replaced

  Resource is tainted, so must be replaced

  HIGH

Official resources & further reading

• 📚Terraform Official Documentation
• DrDroid: Terraform Timeout Diagnosis
• Terraform Resource Provisioners
• 🐙
  GitHub Issue: timeout while waiting for state in Terraform 0.6.12(GitHub)
• AWS Service Limits