There are several ways to access the Remote Run Dialogue:

  • Main menu: TeamCity > Remote Run...
  • Project Explorer > context menu of changed file(s) > Team > Remote Run
  • Editor > context menu > Team > Remote Run
  • TeamCity Local Changes view >

TeamCity Remote Run Dialog

Item Description
Comment Type an optional description of the build.
<Recent comments> Select a comment for the remote run from the drop-down list of recently used comments.
Pre-tested commit Use options on this pane to enable and customize options of the Pre-tested commit function
Commit after build(s) finished Check this option to enable the automatic committing of your changes to the version control if your personal build completes successfully. If you prefer to leave this option unchecked, you can commit your changes manually.
  • Only if build(s) are successful: TeamCity will automatically commit selected changes to the VCS only if the build finishes successfully.
  • If no new test failed:TeamCity will automatically commit selected changes to the VCS even if the finished build is failed, but there is no new test failed since the previous build.
Ask for confirmation before commit If checked, TeamCity will ask for your confirmation to commit changes.
Changes Select your changes to be included into the build. Use the tool bar to navigate between changes and organize the changes view.
Select all Click to select all changes in the view.
Clear selection Click to undo the selection.

Click Next to select applicable build configurations and customize them. Click Run to use previously configured selection and customization.

Remote Run Configuration

Item Description
Applicable configurations This field displays the build configurations available for the projects in a tree structure. Select the check boxes next to the desired configurations you wish to build. At least one configuration needs to be selected.
Tool bar
  • : Click to refresh the list of applicable build configurations.
  • : Click to customize your personal build. See the description of the customizable options below.
  • : Having a build configuration selected, click to clear customization.

Customization

Item Description
Choose an agent to run <build configuration name> Select a particular agent you want to run the build on from the drop-down list. By default, the fastest idle agent is selected.
Run options
  • Put build to the top of the queue: Select this option to put the build to the top position in the Build Queue.
  • Rebuild all Dependencies: Select to enforce rebuilding of all dependencies instead of reusing existing build.
  • Clean all files in checkout directory before build
    • : Select to enforce rebuilding clean checkout. Learn more about clean checkout in the online TeamCity documentation.
Build Parameters Add new system properties and environment variables for the build. Learn more about build parameters in the online TeamCity documentation.