Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  1. In TeamCity Web UI, navigate to the Agents tab
  2. Click the Install Build Agents link and then click download zip file
  3. Unzip the downloaded file into the desired directory.
  4. Make sure that you have a JDK or JRE 1.6+ installed (You will need JDK (not JRE) for some build runners like Ipr runnerIntelliJ IDEA, Java Inspections , and Duplicates). Please ensure that the JRE_HOME or JAVA_HOME environment variables are set (pointing to the installed JRE or JDK directory respectively) for the shell in which the agent will be started.
  5. Navigate to the <installation path>\conf directory, locate the file called and rename it to
  6. Edit the file to specify the TeamCity server URL and the name of the agent. Please refer to Build Agent Configuration section for more details on agent configuration
  7. Under Linux, you may need to give execution permissions to the bin/ shell script.

    On Windows you may also want to install the build agent windows service instead of manual agent startup.





Installed JDK(JRE) 1.6+ required. JVM should be reachable with JAVA_HOME(JRE_HOME) environment variables or be in paths.


  • Installed JDK/JRE 1.6+ is recommended. No preinstalled JRE required. Zipped JRE will be downloaded from source the TeamCity server over during 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).
  • Sysinternals psexec.exe on TeamCity server required. It has to be accessible in paths. You can get install it at Administration -> Server Configuration -> Tools tab.