> ## 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.

# Setup & prerequisites

> Configure Code Optimizer by connecting your VCS with the required permissions, selecting repositories, and meeting self-hosted agent version requirements.

## Prerequisites

Before using Code Optimizer, ensure you have:

**1. User Permissions**

Your permissions determine what you can do in Code Optimizer:

**Admin role or Edit Organization Settings permission:**

* Configure VCS integrations
* Run scans
* Generate fixes

**View Dashboard permission:**

* View Code Optimizer
* Run scans

Learn more: [User Roles & Permissions](https://docs.envzero.com/guides/admin-guide/user-role-and-team-management/user-management.md)

**2. VCS Integration**

Connect your VCS provider with env zero. Choose the connection type based on your provider:

**For GitHub/GitHub Enterprise:**

* **Deployment Pipeline** - Scanning only
* **Code Write** - Scanning + PR creation

**For other VCS providers** (GitLab, Bitbucket, Azure DevOps):

* **Deployment Pipeline** - Scanning only (PR creation not yet supported)

Learn more: [VCS Connection Types](https://docs.envzero.com/guides/admin-guide/manage-vcs.md#connection-types)

**3. Repository Selection**

Select the repositories you want to scan during the VCS integration process. Code Optimizer will scan all authenticated repositories.

**4. Terraform Code**

Code Optimizer supports **Terraform and OpenTofu** (HCL) only.

> [!WARNING]
>
> **Self-Hosted Agent Version Requirement**: Code Optimizer is supported on self-hosted agents from version **v4.0.29** and up. If you're using a self-hosted agent, ensure it's running at least this version to use Code Optimizer features.

## Next steps

> [card] [Start Scanning](https://docs.envzero.com/guides/policies-governance/code-optimizer/scanning.md)
>
> Trigger your first repository scan

> [card] [Generate Fixes](https://docs.envzero.com/guides/policies-governance/code-optimizer/fixes.md)
>
> Create AI-powered pull requests


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.