Trigger a plan
Open your workspace and click Run Plan (or use the API). Forgecroft will:
- Fetch your source from GitHub
- Initialize your tool (OpenTofu or Terraform)
- Read your current state from the backend
- Produce a plan showing what would change
What success looks like
When the plan completes, you should see:
- Status: Completed — the plan ran successfully
- Resource changes — counts of resources that would be added, changed, or destroyed
- Plan output — the full diff of what would change
If it didn’t work
| Symptom | Likely cause | Check |
|---|---|---|
| Plan fails immediately | Wrong repo URL, branch, or source root | Workspace settings → Source |
| Auth error | Invalid or missing credentials | Workspace settings → Credentials |
| State backend error | Bucket doesn’t exist or wrong permissions | Workspace settings → State backend |
| Plan stuck in queued | Managed environment is provisioning | Wait a moment, it should start automatically |
What’s next
Now that you have a working plan, you can:
- Apply the plan to actually make the changes
- Connect more workspaces for other environments
- Set up notifications to get alerted on run results
- Explore stacks to manage multiple environments from one config
- Add governance with policies and approval rules