> ## 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.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.macstadium.com/feedback

```json
{
  "path": "/orka/orka-devops-integrations/teamcity",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# TeamCity plugin for Orka macOS build agents

> Connect Orka to TeamCity using the MacStadium plugin to provision and destroy ephemeral macOS build agents. Covers plugin installation and configuration.

How to use TeamCity with your Orka environment.

MacStadium provides seamless **integration between Orka and[TeamCity](https://www.jetbrains.com/teamcity/)**. The TeamCity plugin automatically spins up and destroys ephemeral agents.

> **IMPORTANT**
>
> Orka 3.1.x and above requires version [2.0.0+](https://plugins.jetbrains.com/plugin/13662-orka-by-macstadium/edit/versions/stable/433857) of the plugin.

## Set up the integration

> **IMPORTANT**
>
> Make sure that your TeamCity server is connected to your Orka environment through VPN. You can use a [VPN client](/orka/networking-with-orka-at-macstadium/vpn-connection) to establish temporary connectivity, or you can create a [site-to-site VPN tunnel](/orka/networking-with-orka-at-macstadium/aws-orka-connections) to keep the connection alive at all times.

MacStadium provides a TeamCity plugin that you need to install and configure. To get the plugin, **[contact us](https://portal.macstadium.com/)**.

For the latest information about how to set up the TeamCity plugin, see [Orka by MacStadium TeamCity Plugin Setup](https://github.com/macstadium/orka-teamcity-plugin/blob/master/wiki/setup.md).

For the latest information about how to use the TeamCity plugin, see [Orka by MacStadium TeamCity Plugin Usage](https://github.com/macstadium/orka-teamcity-plugin/blob/master/wiki/usage.md).

## Known issues

* You might experience a timeout when deploying an Apple ARM-based agent from a VM config for the first time on a node. Every subsequent deployment on the same ARM-based node though will be successful.