Installation

Here is the recommended installation steps for all OS.

Windows

Download the installer based on your system configuration and run it. Click your way through till you're asked to select your language.

Gauge is installed in %PROGRAMFILES% by default. But you can select where you want to install Gauge and complete Gauge installation.

MacOS

The following command installs Gauge.

For this to work, you will need to install homebrew. If you have brew installed then all you need to run is this command; it will download and install Gauge. This requires you to be connected to the Internet.

brew update
brew install gauge

Linux

Download the zip file. Choose the archive file appropriate for your installation. And run the command below to install Gauge.

unzip gauge-$VERSION-$OS.$ARCH.zip
./install.sh

Having trouble with installation? Head over to our Installation FAQ's.

Alternate Methods

Windows

Using Chocolatey

You can install Gauge using Chocolatey as well.

choco install gauge

If you're upgrading to a newer version, then use the command:

choco upgrade gauge

MacOS

Offline Installation (pkg installer)

You can download the Gauge installer. This is a pkg file, so you can click your way through to finish installing Gauge.

Check the Language runner to install language runner plugins.

Linux

On Debian, Ubuntu

Setup

Add Gauge's GPG key:

sudo apt-key adv --keyserver hkp://pool.sks-keyservers.net --recv-keys 023EDB0B

Stable

For stable releases, run this command to add URL to repository list:

echo deb https://dl.bintray.com/gauge/gauge-deb stable main | sudo tee -a /etc/apt/sources.list

Nightly

Nightly releases are latest development snapshots of Gauge. They have the latest features being developed, but are unstable. If you want to try out Gauge nightly, do this:

echo deb https://dl.bintray.com/gauge/gauge-deb nightly main | sudo tee -a /etc/apt/sources.list
Install
sudo apt-get update
sudo apt-get install gauge

To set up necessary environment variables and download basic reporting plugins, run this command as a regular user to complete installation:

gauge_setup

On RHEL, Fedora, CentOS

Setup

Stable

For stable releases, create file /etc/yum.repos.d/gauge-stable.repo with the following content:

[gauge-stable]
name=gauge-stable
baseurl=http://dl.bintray.com/gauge/gauge-rpm/gauge-stable
gpgcheck=0
enabled=1

You can use this command to do it in one step:

echo -e "[gauge-stable]\nname=gauge-stable\nbaseurl=http://dl.bintray.com/gauge/gauge-rpm/gauge-stable\ngpgcheck=0\nenabled=1" | sudo tee /etc/yum.repos.d/gauge-stable.repo

Nightly

Note: Nightly releases are latest development snapshots and can be unstable.

For nightly releases, create /etc/yum.repos.d/gauge-nightly.repo with the following content:

[gauge-nightly]
name=gauge-nightly
baseurl=http://dl.bintray.com/gauge/gauge-rpm/gauge-nightly
gpgcheck=0
enabled=1

You can use this command to do it in one step:

echo -e "[gauge-nightly]\nname=gauge-nightly\nbaseurl=http://dl.bintray.com/gauge/gauge-rpm/gauge-nightly\ngpgcheck=0\nenabled=1" | sudo tee /etc/yum.repos.d/gauge-nightly.repo
Install

Install on Fedora:

sudo dnf install gauge

Install on CentOS/RHEL:

sudo yum install gauge

To set up necessary environment variables and download basic reporting plugins, run this command as a regular user to complete installation:

gauge_setup
Install manually

Download the zip file. Choose the archive file appropriate for your installation. And run the command below to install Gauge.

unzip gauge-$VERSION-$OS.$ARCH.zip
./install.sh

Having trouble with installation? Head over to our Installation FAQ's.

Plugins

Language runner

C#

gauge --install csharp

Java

gauge --install java

Ruby

gauge --install ruby

One can use IDEs to create the projects and run specifications, for this example, we are using the command line options.

Reporting plugin

HTML Reports

gauge --install html-report

XML Reports

gauge --install xml-report

Verify your installation

You can check the version of your plugin and Gauge core by executing the following command.

gauge -v

If this enlists a version then you're intallation and initialisation is has been successful. Your output will look like this:

Gauge version: <version number>

Plugins
-------
plugin(<version number>)

You can read more about plugins here.

If you have Gauge and your language runner installed, then see how you can create a Gauge project.

Uninstallation

Gauge

Warning

If you plan to remove Gauge and the installed plugins, follow the steps in Plugins first.

To uninstall Gauge, run the following commands:

OS X/Linux

rm -rf /usr/local/bin/gauge /usr/local/share/gauge /usr/local/share/gauge_screenshot ~/.gauge

If Gauge is installed in custom location, user will have to remove corresponding files/directory.

Windows

Run the executable uninst.exe found in Gauge install location.

More on Gauge install location can be found here <troubleshoot_gauge_installation>.

Plugins

Plugins can be uninstalled using the uninstall flag. The command is

gauge --uninstall <plugin-id>

Example:

gauge --uninstall java

To uninstall a specific version of the plugin, use the --plugin-version flag.

Example:

gauge --uninstall java --plugin-version 0.3.2