Self-hosted agents with cloud pipeline orchestration
What is this?
Buildkite runs builds on agents you host, orchestrated from a cloud dashboard.
Where to create or edit the main configuration — paths below match the setup steps.
.buildkite/pipeline.ymlLocation: Repository → .buildkite/ (or pipeline path in UI)
Agent steps and command blocks
Step 01
1# Install agent2curl -fsSL https://apt.buildkite.com/buildkite-agent.gpg.key | sudo apt-key add -3echo "deb https://apt.buildkite.com/buildkite-agent stable main" | sudo tee /etc/apt/sources.list.d/buildkite-agent.list4sudo apt-get update && sudo apt-get install -y buildkite-agentStep 02
Default path is .buildkite/pipeline.yml — or set a custom path in the Buildkite UI.
1mkdir -p .buildkite2cat > .buildkite/pipeline.yml << 'EOF'3steps:4 - label: ":nodejs: Test"5 command: npm ci && npm test6EOF7git add .buildkite/pipeline.yml && git commit -m "Add Buildkite pipeline" && git pushStep 03
1buildkite-agent --version