Skip to content

Self-hosted execution, step by step

Choose this path if you want self-hosted execution, cloud credentials to stay local, and a step-by-step secure setup flow.

Looking for the CLI? The forgecroft-agent daemon on this page is not the Forgecroft CLI. The agent executes runs on your infrastructure; the CLI triggers runs and reads logs from anywhere. Most users want both. See CLI vs Agent.

  • Getting Started — create an API key, start the agent binary, and point a workspace at it
  • How It Works — the polling model, credential boundaries, heartbeat and timeout behaviour
  • Running Reliably — deploy the agent as a systemd service, Docker container, or Kubernetes deployment