Getting Started

This guide helps you set up Zenfra and run your first infrastructure workflow.

Prerequisites

Before you begin, make sure you have:

• Access to a Git provider account (GitHub or GitLab)
• Access to at least one cloud account (AWS, Azure, or GCP)
• A repository with Terraform or OpenTofu code
• Permission to create stacks and runs in your Zenfra organization

Quick start

1. Connect your source control
2. Add your Git integration in Zenfra.

3. Select the repository that contains your IaC code.

4. Connect your cloud account

5. Configure cloud credentials or OIDC trust.

6. Verify Zenfra can assume the required role.

7. Create your first stack

8. Choose repository and branch.
9. Set root path and IaC tool version.

10. Assign a worker pool.

11. Trigger your first run

12. Open the stack and trigger a run.
13. Review the plan output.
14. Approve and apply if changes look correct.

What to do next

As we expand this portal, the next recommended topics are:

• Stacks and spaces
• Runs and approvals
• Worker pools
• Policies and RBAC
• API reference