Agent

Getting Started with the Forgecroft Agent

Use the agent when you want runs to execute inside your own network with cloud credentials that stay local.

What you need

Your Forgecroft API URL
An organization API key from Forgecroft
git and tofu installed on the machine that will run the agent
Cloud credentials available on that machine

Three steps

1. Create an organization API key In Forgecroft, go to Settings → Infrastructure → API Keys. Create a new API key for your agent and copy it somewhere secure. You will use it as FORGECROFT_API_KEY.

2. Start the agent Set FORGECROFT_API_URL and FORGECROFT_API_KEY, then start the agent.

export FORGECROFT_API_URL=https://api.forgecroft.com
export FORGECROFT_API_KEY=fc_live_...

./forgecroft-agent

3. Point a workspace at the agent In the workspace settings, set execution mode to agent. Future runs for that workspace will be handed to your self-hosted agent.

Important note

The Forgecroft API key is only for agent-to-Forgecroft authentication. Your actual cloud access still comes from the environment where the agent runs.

AWS instance profiles
Kubernetes workload identity
Local SDK credentials
Environment variables