TeamCity is a powerful and user-friendly Continuous Integration and Deployment server that works out of the box.

Integrating Gauge with TeamCity

  • Download and Install Gauge on the agents. Read more on installing Gauge here.
  • Install the required Gauge language plugins on the agents as: gauge --install <language>

Tips on Installation

  • Gauge is installed system wide by default and not user wide. However, plugins are installed per user. So plugins should be installed via user account with which the TeamCity agent executes. Refer default install location of Gauge and its plugins here.

  • Alternately, you can set custom location for plugins so that its accessible to TeamCity agent running as a different user.

Create execution task

  • Create a new project in TeamCity pointing to Gauge project repository URL.
  • Add a build step which will run gauge specs. New build step

  • If you want to run only a subset of specs, you can use tags. Eg. gauge --tags "tag1 & tag2" specs

  • Adding a flag -p runs them in parallel.
  • Run against specific environments using the --env flag
  • See the Gauge CLI for list of all flags that can be used.


  • Gauge generates html-reports after execution which can be configured in TeamCity by adding a new artifact in Artifacts tab. These artifacts can be viewed/downloaded from the artifacts tab.


  • You can also add a custom tab to view your html reports generated.

    To add custom tab, go to Project Settings -> Report tabs -> Add a new build report tab.


  • Console output can be seen while execution of steps and reports can be seen after execution.

results matching ""

    No results matching ""