Essentials
Everything You Can Configure From the Sidebar
Use this page as a simple tour of the Forgecroft sidebar and the main things each section controls.
Core concepts
Organization is your top-level account boundary.
Project groups related workspaces together.
Workspace is one infrastructure root that Forgecroft can plan and apply.
Projects
- Create a project
- Set its name and description
- Add or remove project members
- Choose a default tool config
- Attach notification configs
Workspaces
- Name
- Source repository URL, branch, and root
- VCS integration
- Credentials
- State backend and state key
- Tool config
- Execution mode
- Auto-plan and auto-apply
- Notifications
- PR comments
- Deletion protection
Settings
General lets you view and update basic organization details.
Members lets you invite people, manage roles, and review pending invites.
Infrastructure
Infrastructure settings define reusable building blocks that projects and workspaces can reference.
- Tools: named tool and version combinations
- Credentials: reusable cloud credential configs
- State Backends: reusable backend definitions
- VCS Integrations: source provider connections
- Notifications: reusable notification channels
- API Keys: machine credentials for automation and agents
Governance
Governance is optional at first. Add it after your first working workspace.
- Groups: named approver groups
- Policy Sets: policy-as-code checks against plans
- Approval Rules: when a run needs human approval