Work in Progress - Some features may be incomplete or subject to change

F.A.Q's

Choose the plan that fits your infrastructure needs

Have a question not answered here?

Email us at support@terraback.io

What is Terraback?

Terraback is a powerful infrastructure-as-code tool that automatically reverse-engineers your existing cloud infrastructure into clean, maintainable Terraform configurations. It discovers resources across AWS, Azure, and Google Cloud, maps their dependencies, and generates production-ready Terraform files in seconds.

How is Terraback different from native Terraform import?

Unlike Terraform's native import which requires manual resource-by-resource importing and writing configurations from scratch, Terraback:

  • Automatically discovers all resources in your cloud accounts
  • Generates complete Terraform configurations with all arguments
  • Maps resource dependencies intelligently
  • Handles complex relationships between resources
  • Saves 90% of migration time compared to manual approaches
  • Supports bulk operations across entire infrastructures

Which cloud providers does Terraback support?

Terraback currently supports:

  • AWS: 50+ services including EC2, VPC, RDS, Lambda, S3, IAM, and more
  • Azure: 20+ services including VMs, Networks, Storage, AKS, and more
  • Google Cloud: 15+ services including Compute, Networks, GKE, and more

We're continuously adding support for more services based on user demand.

Is Terraback secure?

Yes, Terraback is designed with security as a top priority:

  • Runs locally on your machine - no data sent to external servers
  • Uses read-only permissions - cannot modify your infrastructure
  • No credentials stored - uses your existing cloud CLI authentication
  • Machine fingerprinting - licenses tied to specific machines
  • Offline validation - works without internet after activation

What are the system requirements?

  • Operating Systems: Windows 10+, macOS 10.15+, Linux (Ubuntu 18.04+, CentOS 7+)
  • Memory: Minimum 4GB RAM (8GB recommended for large infrastructures)
  • Disk Space: 500MB for installation
  • Cloud CLI Tools: AWS CLI, Azure CLI, or gcloud SDK (depending on your provider)
  • Python: 3.8 or higher

How do I install Terraback?

# Using pip
pip install terraback
# Or download the binary directly from
https://terraback.io/download

How do I authenticate with my cloud provider?

Terraback uses your existing cloud CLI credentials:

# AWS
aws configure
terraback scan aws
# Azure
az login
terraback scan azure
# Google Cloud
gcloud auth login
terraback scan gcp

How do I scan my infrastructure?

Simply run:

# Scan all resources in current AWS account
terraback scan aws
# Scan specific AWS region
terraback scan aws --region us-west-2
# Scan specific resource types
terraback scan aws --services ec2,rds,s3
# Generate Terraform files
terraback scan aws --output ./terraform-output

What output formats are supported?

Terraback generates:

  • Terraform HCL (.tf files) - Default, human-readable format
  • Import blocks - For Terraform 1.5+ import functionality
  • Import scripts - Shell scripts for state import
  • Resource documentation - Markdown files with resource inventory

How do I handle existing Terraform state?

Terraback provides multiple approaches:

  1. Generate import blocks (Terraform 1.5+):
terraback scan aws --use-import-blocks
  1. Generate import scripts:
terraback scan aws --generate-imports
  1. Import specific resources:
terraback scan aws --import-state

Can I exclude certain resources?

Yes, you can exclude resources using:

# Exclude by service
terraback scan aws --exclude ec2,rds
# Exclude specific resources
terraback scan aws --exclude-resources instance-id,bucket-name

What are the different editions?

  • Community Edition: Free tier with core scanning features (limited to 10 resources per scan)
  • Migration Pass: $299 per user for 3 months, includes professional features
  • Professional: Coming soon - Annual licensing
  • Enterprise: Coming soon - Custom pricing with advanced features

What's included in the Migration Pass?

  • Unlimited scanning across all cloud providers
  • All 50+ AWS services support
  • All Azure and GCP services support
  • Import block generation for Terraform 1.5+
  • Parallel processing for faster scans
  • 3 months of updates
  • Email support

How does the Beta Program work?

We currently offer a Beta Program that provides:

  • Early access to new features
  • Professional tier features for testing
  • Access to our Slack community
  • 90-day beta access period

To join: terraback beta register

Do I need a license for CI/CD pipelines?

The Migration Pass license can be used on your development machine. CI/CD usage requires appropriate licensing based on your edition.

Why are some resources not being discovered?

Common causes:

  1. Insufficient permissions - Ensure read access to all services
  2. Region restrictions - Check if scanning the correct region
  3. Service limitations - Some resources may not be supported yet

Run with --debug flag for detailed diagnostics.

How do I handle circular dependencies?

Terraback automatically detects and resolves most circular dependencies. For complex cases, the tool will generate resources with proper depends_on blocks.

The scan is taking too long

For large infrastructures:

  • Use --services flag to scan specific services only
  • Use --region to limit to specific regions
  • Use --parallel to increase concurrent operations (Migration Pass only)

How do I report bugs or request features?

  • Email: support@terraback.io
  • Beta Community Slack: Available for beta program members
  • Website: Contact form at https://terraback.io/contact

Can I scan multiple AWS accounts?

With Migration Pass or higher:

# Scan with specific profile
terraback scan aws --profile production
# Scan multiple profiles
terraback scan aws --all-profiles

How do I use Terraback with multiple regions?

# Scan all regions
terraback scan aws --all-regions
# Scan specific regions
terraback scan aws --regions us-west-2,eu-west-1

Can I customize the output?

# Custom output directory
terraback scan aws --output ./my-terraform
# Organize by service
terraback scan aws --group-by service
# Single file output
terraback scan aws --single-file

How do I validate my license?

# Check license status
terraback license status
# Activate a license
terraback license activate YOUR-LICENSE-KEY
# For beta users
terraback beta status

How fast is Terraback?

Scanning speed depends on infrastructure size:

  • Small (< 100 resources): ~30 seconds
  • Medium (100-1000 resources): 2-5 minutes
  • Large (1000+ resources): 10-20 minutes

Migration Pass includes parallel scanning for improved performance.

Can Terraback handle large infrastructures?

Yes! Terraback has been tested with infrastructures containing:

  • 1,000+ EC2 instances
  • 5,000+ Lambda functions
  • 10,000+ S3 objects

The tool uses efficient caching and pagination to handle large-scale environments.

How can I improve scanning performance?

# Use caching (automatically enabled)
terraback scan aws --cache
# Scan specific services only
terraback scan aws --services ec2,vpc
# Use regional scanning
terraback scan aws --region us-west-2

Where can I find documentation?

  • Official Docs: https://docs.terraback.io
  • Website: https://terraback.io
  • README: Included with installation

How do I get support?

  • Email Support: support@terraback.io (Migration Pass customers)
  • Beta Slack Community: For beta program members
  • Website Contact: https://terraback.io/contact

What information should I provide when requesting support?

When contacting support, please include:

  • Terraback version (terraback --version)
  • Cloud provider and region
  • Error messages or logs (--debug output)
  • Number of resources being scanned
  • Your license type (Community, Migration Pass, Beta)

How often is Terraback updated?

  • Regular updates: Monthly feature releases
  • Security patches: As needed
  • Beta features: Continuous deployment for beta users

Updates are included with your Migration Pass for the duration of your license.