> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macstadium.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Buildkite

> Connect Orka to Buildkite with the MacStadium plugin. Use permanent agents reused across builds or ephemeral agents created per pipeline run.

How to use Buildkite with your Orka environment.

MacStadium provides seamless **[integration between Orka and Buildkite](https://github.com/macstadium/orka-integrations/tree/master/Buildkite)**. You can work with permanent or ephemeral agents.

<Warning>Orka 3.1.x and above requires version [v2.0.0+](https://github.com/macstadium/orka-integrations/releases/tag/v2.0.0) of the plugin.</Warning>

## Set Up a Permanent Agent

Permanent agents are useful when you need to reuse your agents frequently and you don't want to recreate them every time.

For the latest information about how to set up a permanent Buildkite agent, see [Using a Permanent Buildkite Agent to Run CI/CD Pipelines in Orka](https://github.com/macstadium/orka-integrations/tree/master/Buildkite/permanent-agent.md).

## Set Up an Ephemeral Agent

Ephemeral agents are useful when you want to automatically create and delete agents based on the needs of your workflows.

For the latest information about how to set up an ephemeral Buildkite agent, see [Using an Ephemeral Buildkite Agent to Run CI/CD Pipelines in Orka](https://github.com/macstadium/orka-integrations/tree/master/Buildkite/ephemeral-agent.md).