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/downloadHow 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 gcpHow 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-outputWhat 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:
- Generate import blocks (Terraform 1.5+):
terraback scan aws --use-import-blocks- Generate import scripts:
terraback scan aws --generate-imports- Import specific resources:
terraback scan aws --import-stateCan 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-nameWhat 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:
- Insufficient permissions - Ensure read access to all services
- Region restrictions - Check if scanning the correct region
- 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
--servicesflag to scan specific services only - Use
--regionto limit to specific regions - Use
--parallelto 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-profilesHow 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-1Can 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-fileHow 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 statusHow 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-2Where 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 (
--debugoutput) - 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.