Tutorial: 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 run specs.
    image:: images/TeamCity_buildStep.png
  • If you want to run only a subset of specs, you can use Specify Tags.
    Eg. gauge run --tags "tag1 & tag2" specs
  • Adding a flag -p runs them using Parallel Execution.
  • Run against specific Environments using the --env flag.
  • See the Manpage <https://manpage.gauge.org> __ for list of all the 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.

    report tab


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