Child pages
  • Agent Push
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »


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

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:

  • from Unix based TC Server agents can be installed to Unix hosts only(via SSH).
  • from Windows ones agents can be installed to Unix (via SSH) or Windows(via psexec)
  • SSH note: Make sure "Password" or "Public key" authentication is enabled on the target host according to preferred authentication method.

Requirements for Agent's hosts:

  • Unix: installed JDK(JRE). JVM should be reachable with JAVA_HOME(JRE_HOME) environment variables or be in paths. Also, unzip must be installed and available in path.
  • Windows: No preinstalled JRE required. Zipped JRE will be downloaded from source TCServer over the installation phase(there is no JRE's zip bundled to TC Server now, you have to put "" archive under "TEAMCITY_SERVER_ROOT/webapps/ROOT/update" folder)

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.


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

  • No labels