This page is obsolete. Please refer to the Agent Push description in the latest TeamCity documentation.

General Info




Apache 2.0


free, open-source

Plugin Description

Agent Push allows to install TeamCity Agent to remote host.

Currently supported combinations of Server host platform and targets for Agents:

Requirements for Agent's hosts:

Plugin Development Status

In final stage of development.

Bundled since 6.5 release (experimental).

TeamCity Versions Compatibility

The current plugin version is designed to work with TeamCity 6.x.



Installation instructions

  1. Put into   <TeamCity Data Directory\>/plugins folder.
  2. Restart the server.

Plugin usage

Сonfiguring Agent's installation via UI options

The plugin provides web UI configuration page ("Agents/Agent Push" tab) which allows to install an Agent to required host or manage persisted installation's profiles(presets):

  1. Push "Install Agent.." and configure mandatory attribute for simple installation.  
  2. "Create new preset" if you are going to use same settings for several target host. It is possible to choose early saved presets during "Install Agent..." action.

Installing agent to cloud

The plugin also gives an ability to install TeamCity agent on Amazon EC2. Specify Agent Push preset in Cloud profile settings and when TeamCity starts an image in the cloud, the agent is pushed on the image automatically, so you do not need to install it on the image and modify build agent configuration to specify correct server URL.


h3. Known Issues


If you believe you've faced a bug: Issue Tracker (project: TeamCity)
If you want to ask a question or discuss: Forum

Development links