Overview Quick Start Setup Guide Examples Pricing InfraMorph FAQ Troubleshooting Security

Troubleshooting

Common issues and solutions for InfraMorph users.

API Connection Issues

API Token Not Working

  • Symptom: "Invalid API token" or "Authentication failed" errors
  • Solutions:
  • Double-check your API token was copied correctly (no extra spaces)
  • Verify the token hasn't expired
  • Ensure you're using the correct token for your cloud provider
  • For DigitalOcean: Generate a new token with Read scope
  • For AWS: Verify IAM user has ReadOnlyAccess policy
  • For Azure: Confirm service principal has Reader role

Permission Denied Errors

  • Symptom: "Access denied" or "Insufficient permissions" when scanning
  • Solutions:
  • DigitalOcean: Ensure API token has "Read" permissions
  • AWS: Add these policies to your IAM user:
    • ReadOnlyAccess
    • EC2ReadOnlyAccess
    • RDSReadOnlyAccess
    • S3ReadOnlyAccess
  • Azure: Assign "Reader" role to your service principal at subscription level

Connection Timeout

  • Symptom: "Connection timeout" or "Request timed out"
  • Solutions:
  • Check your internet connection
  • Verify cloud provider API status (status pages)
  • Try again in a few minutes
  • Contact support if timeouts persist

Terraform Generation Issues

Incomplete Infrastructure Scan

  • Symptom: Missing resources in generated Terraform
  • Solutions:
  • Verify API credentials have access to all resource types
  • Check if resources are in supported regions
  • Ensure resources aren't in "paused" or "archived" state
  • Some legacy resources may not be supported

Download Fails

  • Symptom: "Download failed" or corrupted ZIP file
  • Solutions:
  • Clear browser cache and try again
  • Try a different browser
  • Ensure stable internet connection
  • Download expires after 30 days - generate new scan if needed

Empty Terraform Files

  • Symptom: Downloaded files contain no resources
  • Solutions:
  • Verify you have actual infrastructure in your cloud account
  • Check API token has read access to your resources
  • Ensure resources are in supported regions

Account Issues

Scan Not Starting

  • Symptom: "Start InfraMorph" button doesn't work
  • Solutions:
  • Complete API connection test first
  • Refresh the page and try again
  • Clear browser cache
  • Disable browser ad blockers temporarily

Session Expired

  • Symptom: "Please log in again" messages
  • Solutions:
  • Log out and back in
  • Clear browser cookies for inframorph.com
  • Check if your subscription is still active

Getting Help

Contact Support

If these solutions don't resolve your issue: - Email: [email protected] - Include: - Your subdomain (e.g., company.inframorph.com) - Cloud provider you're using - Error message (if any) - Steps you tried

Documentation