The first step connects env zero to your Terraform Cloud (TFC) or Terraform Enterprise (TFE) organization and automatically discovers all workspaces, variables, and variable sets. Provide your API token and env zero scans your organization automatically.Documentation Index
Fetch the complete documentation index at: https://docs.envzero.com/llms.txt
Use this file to discover all available pages before exploring further.
Connect your TFC organization
Enter your TFC organization details
Provide two fields:
- Terraform Cloud Organization Name - the exact name of your TFC/TFE organization (for example,
acme-corp) - Terraform Cloud API Token - a user or team token with read permissions and permissions to lock/unlock workspaces
If you previously started a migration for this TFC organization, the wizard resumes your existing session.
Scan progress
After connecting, the wizard scans your TFC organization in three phases:- Workspaces - discovers all workspaces and their variables
- Variable Sets - discovers variable sets and their variables
- Projects - maps TFC projects to env zero projects
Select scope
Once scanning completes, the wizard displays all discovered workspaces organized by TFC project.Review discovered workspaces
The tree view shows your TFC projects and their workspaces. Each workspace displays its current status:
- Migrated - already migrated in a previous session
- Live - already live in env zero
- Excluded - manually excluded from this migration round; click the chip to include it again
- Unsupported VCS provider - the workspace uses a VCS provider not supported by the wizard (supported providers: GitHub, GitLab, Bitbucket, and Azure DevOps including self-hosted). These workspaces cannot be migrated with the wizard.
Select workspaces to migrate
Check the workspaces you want to migrate in this round. You can select entire projects or individual workspaces. Use the search bar to filter by workspace name. You do not need to select all workspaces at once. Migrate a subset now and return later to continue with the rest.
The summary at the bottom shows your total workspace count, selected count, and already-migrated count. Workspaces migrated in previous rounds are marked as Migrated and cannot be selected again.
Re-scanning
If your TFC organization has changed since the initial scan, click the Re-scan button next to the organization name to refresh the workspace list.Next steps
- Resolve Issues - Provide missing secrets and fix VCS connection gaps.
- Migrate from Terraform Cloud - Return to the migration overview for the full process.
- Troubleshooting - Fix credential errors and scan failures.