Step 1: Create a project
Go to Projects in the console and create a project. Use a simple name like Infrastructure or Platform.
A project groups related workspaces together. For now, one project is all you need.
Step 2: Create a workspace
Open your project and click Create Workspace. Fill in:
- Workspace name — something descriptive like
productionorstaging - Source repository URL — the HTTPS URL of your GitHub repo
- Source branch — the branch to run plans against (usually
main) - Source root — the directory inside the repo where your IaC code lives. Use
/if it’s at the root
Step 3: Choose managed execution
For your first setup, select managed execution. Forgecroft runs the plan in its own secure environment — no runners to install or configure.
Step 4: Attach credentials
Create a credential config that matches your cloud provider:
- AWS — static access key/secret key, or assume role
- GCP — service account key
- Cloudflare — API token
Then attach the credential to your workspace.
Step 5: Attach a state backend
Create a state backend config (S3 or GCS) and attach it to your workspace. Set a state key if you want a specific path, or leave it blank and Forgecroft will generate one.
You’re now connected. Next, run your first plan.