Skip to main content

Integrate BrowserStack Automate with AWS CodePipeline

A guide to help you integrate AWS CodePipeline with the BrowserStack device cloud for running all your tests.


AWS CodePipeline is a continuous delivery service that helps you automate your build and deploy stages, which leads to faster product delivery and early mitigation of issues. It lets you integrate your source code from multiple sources,such as GitHub, bitbucket, Amazon S3, etc, monitor it continuously for any code change, and generate builds when any change is detected. Just like any continuous delivery service, AWS CodePipeline helps teams deliver features and updates rapidly.

The buildspec.yml file includes configurations that BrowserStack uses to authenticate and run the test cases. You can use the information in this section to edit the .yml file and add configurations, such as, BrowserStack credentials, Local settings, and so on. For your existing repositories that use AWS CodePipeline, integrating BrowserStack requires minimal changes to your environment.

  • This guide requires some knowledge of AWS Codepipeline. Check out AWS Codepipeline documentation before configuring BrowserStack.
  • If you are new to BrowserStack, take some time to check out the getting started guides to learn about integrating BrowserStack with your existing test scripts.

The following sections guide you through setting up BrowserStack to test your websites or locally hosted staging environments:

Integrate existing test cases

With existing test cases, integrating BrowserStack involves:

  • Setting up BrowserStack credentials as environment variables.
  • Editing your test cases to add BrowserStack capabilities.


Before you can start integration, ensure that the following tasks are complete.

  • Access to AWS CodePipeline as an administrator
  • Access as an administrator to the project repository
  • buildspec.yml file exists for your project
  • You are a maintainer or owner of the project
  • Access to the BrowserStack account credentials, namely Access Key and Username

Set up BrowserStack Access Key and Username

As a best practice, it is recommended that the BrowserStack Access key and Username is set as a variable at the build stage when you create a pipeline.

Set up the credentials using the following steps:

  1. Log in to your AWS management console, click Services and select CodePipeline.
  2. On the Pipelines page, click Create Pipeline.
  3. Configure the following options in Step1: Choose pipeline settings:
    a. Enter a name for your pipeline.
    b. Under Service role, select New service role.
  4. Configure the following options in Step2: Add source stage:
    a. Under Source Provider, select the source repository where your code resides.
    Note: Based on the provider that you select, the connection process will change.
    b. Under Repository name, select the repository.
    c. Under Branch name, select the branch name.
  5. Configure the following options in the Step3: Add build stage:
    a. Under Build provider, select AWS CodeBuild.
    Note: The build provider, AWS CodeBuild, is used as an example.
    b. Under Region, select a region.
    c. Under Project name, select an existing project or click Create project.
    Note: It is recommended that a project is created before you begin with this configuration. This project name is used to identify the builds in the Automate dashboard.
    d. Under Environment variables, click Add environment variable to add the BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY. Set variables in AWS Codepipeline
    Note: It is recommended that the Access Key value is managed using the Secrets Manager.
    e. Click Next.
  6. Configure the following options in the Step4: Add deploy stage:
    a. Under Deploy provider, select a deploy provider, if using the deploy stage.
    b. Click Next.
  7. Review the configuration and click Create Pipeline.

You can also pass the BrowserStack Username and Access key as variables in the buildspec.yml file of each project or repository that you want to test.

    # Set to true when using Local.
    # Set when using multiple Local instances.
    # Set an appropriate build name as a best practice. This helps group tests under the same name for better visibility in the Automate dashboard.

Edit your test scripts

Though your existing test scripts include capabilities, BrowserStack also provides specific capabilities that help determine how tests are run. The following example code snippet sets the OS to windows and the browser to Chrome.

Set capabilities using the following code snippet:

String username = System.getenv("BROWSERSTACK_USERNAME");
String accessKey = System.getenv("BROWSERSTACK_ACCESS_KEY");
String browserstackLocal = System.getenv("BROWSERSTACK_LOCAL");
String browserstackLocalIdentifier = System.getenv("BROWSERSTACK_LOCAL_IDENTIFIER");
String buildName = System.getenv("BROWSERSTACK_BUILD_NAME");

DesiredCapabilities capabilities = new DesiredCapabilities();
capabilities.setCapability("os", "Windows");
capabilities.setCapability("browser", "chrome");
capabilities.setCapability("build", buildName);
capabilities.setCapability("browserstack.local", browserstackLocal);
capabilities.setCapability("browserstack.localIdentifier", browserstackLocalIdentifier);
driver = new RemoteWebDriver(new URL("https://" + username + ":" + accessKey + ""), capabilities);
username = process.env.BROWSERSTACK_USERNAME
accessKey = process.env.BROWSERSTACK_ACCESS_KEY
browserstackLocal = process.env.BROWSERSTACK_LOCAL
browserstackLocalIdentifier = process.env.BROWSERSTACK_LOCAL_IDENTIFIER
buildName = process.env.BROWSERSTACK_BUILD_NAME

var capabilities = {
 "os" : "Windows",
 "browser" : "chrome",
 "browserstack.local" : browserstackLocal,
 "browserstack.localIdentifier" : browserstackLocalIdentifier,
 "browserstack.user" : username,
 "browserstack.key" : accessKey,
 "build" : buildName

var driver = new webdriver.Builder().
String username = Environment.GetEnvironmentVariable("BROWSERSTACK_USERNAME");
String accessKey = Environment.GetEnvironmentVariable("BROWSERSTACK_ACCESS_KEY");
String browserstackLocal = Environment.GetEnvironmentVariable("BROWSERSTACK_LOCAL");
String browserstackIdentifier = Environment.GetEnvironmentVariable("BROWSERSTACK_LOCAL_IDENTIFIER");
String buidName = Environment.GetEnvironmentVariable("BROWSERSTACK_BUILD_NAME");

OpenQA.Selenium.Chrome.ChromeOptions capability = new OpenQA.Selenium.Chrome.ChromeOptions();
capability.AddAdditionalCapability("os_version", "10", true);
capability.AddAdditionalCapability("resolution", "1920x1080", true);
capability.AddAdditionalCapability("browser", "Chrome", true);
capability.AddAdditionalCapability("browser_version", "91.0", true);
capability.AddAdditionalCapability("os", "Windows", true);
capability.AddAdditionalCapability("name", "BStack-[C_sharp] Sample Test", true); // test name
capability.AddAdditionalCapability("build", buidName, true); // CI/CD job or build name
capability.AddAdditionalCapability("browserstack.user", username, true);
capability.AddAdditionalCapability("browserstack.key", accessKey, true);
capability.AddAdditionalCapability("browserstack.local", browserstackLocal, true);
capability.AddAdditionalCapability("browserstack.localIdentifier", browserstackIdentifier, true);
driver = new RemoteWebDriver(
  new Uri(""), capability
$username = getenv('BROWSERSTACK_USERNAME');
$accessKey = getenv('BROWSERSTACK_ACCESS_KEY');
$browserstackLocal = getenv('BROWSERSTACK_LOCAL');
$browserstackLocalIdentifier = getenv('BROWSERSTACK_LOCAL_IDENTIFIER');
$buildName = getenv('BROWSERSTACK_BUILD_NAME');

$caps = array(
  "os_version" => "10",
  "resolution" => "1920x1080",
  "browser" => "Chrome",
  "browser_version" => "latest",
  "os" => "Windows",
  "name" => "BStack-[Php] Sample Test", // test name
  "build" => "".$buildName, // CI/CD job or build name
  "browserstack.local" => "".$browserstackLocal,
  "browserstack.localIdentifier" => "".$browserstackLocalIdentifier
$web_driver = RemoteWebDriver::create(
username = os.environ.get('BROWSERSTACK_USERNAME')
accessKey = os.environ.get('BROWSERSTACK_ACCESS_KEY')
browserstackLocal = os.environ.get('BROWSERSTACK_LOCAL')
browserstackLocalIdentifier = os.environ.get('BROWSERSTACK_LOCAL_IDENTIFIER')
buildName = os.environ.get('BROWSERSTACK_BUILD_NAME')

desired_cap = {
 'browser': 'Chrome',
 'browser_version': 'latest',
 'os': 'Windows',
 'os_version' : '10',
 'name': 'BStack-[Python] Sample Test', # test name
 'build': buildName, # CI/CD job or build name
 'browserstack.user': username,
 'browserstack.key': accessKey,
 'browserstack.local': browserstackLocal,
 'browserstack.localIdentifier': browserstackLocalIdentifier
driver = webdriver.Remote(
browserstackLocal = ENV['BROWSERSTACK_LOCAL']
browserstackLocalIdentifier = ENV['BROWSERSTACK_LOCAL_IDENTIFIER']

caps =
caps["os"] = "Windows"
caps["os_version"] = "10"
caps["browser"] = "Chrome"
caps["browser_version"] = "latest"
caps['javascriptEnabled'] = 'true'
caps['name'] = 'BStack-[Ruby] Sample Test' # test name
caps['build'] = buildName # CI/CD job or build name
caps['browserstack.local'] = browserstack_local
caps['browserstack.localIdentifier'] = browserstackLocalIdentifier
driver = Selenium::WebDriver.for(:remote,
  :url => "https://"+username+":"+accessKey+"",
  :desired_capabilities => caps)
my $browserstackLocal = $ENV{"BROWSERSTACK_LOCAL"};
my $browserstackLocalIdentifier = $ENV{"BROWSERSTACK_LOCAL_IDENTIFIER"};

my $caps = {
  "os" => "Windows",
  "browser" => "chrome",
  "build" => $buildName,
  "browserstack.local" => $browserstackLocal,
  "browserstack.localIdentifier" => $browserstackLocalIdentifier

my $host = "$username:$accessKey\";

my $driver = new Selenium::Remote::Driver('remote_server_addr' => $host,
  'port' => '80', 'extra_capabilities' => $caps);

Integrate test cases for locally hosted websites

If you are testing websites hosted locally as part of your testing or development environment, configure your buildspec.yml file to use the BrowserStack Local binary and route your tests through the local server. Apart from setting up a Local connection, you must also add the browserstack.local capability in your test scripts.

Integrating test cases for locally hosted websites involves:

  • Enabling Local testing
  • Adding browserstack.local capability

Before you configure the buildspec.yml file, complete the following task:

Enable Local Testing

If you chose to use BrowserStack Local binary as a way to establish a local connection, in the buildspec.yml file you must configure the pre_build phase to automatically download and start the binary.

Edit your existing buildspec.yml file to include the code in the following snippets.

       #Download the browserstack binary file .
       - wget ""
       #Unzip the BrowserStack Local binary file
       - unzip
       #Run the file with your access key
       - ./BrowserStackLocal --key $BROWSERSTACK_ACCESS_KEY --daemon start

If you are using a Windows image, then add the following lines to download and run the BrowserStack Local executable file.

       #Download the browserstack binary file .
       - wget ""
       - powershell.exe D:\BrowserStackLocal.exe

Note: Ensure that you also configure the build phase using the following command to stop the the binary after the test run is complete.

          - <your_test_command>
          - ./BrowserStackLocal --key $BROWSERSTACK_ACCESS_KEY --daemon stop

If you prefer to manage the Local connection through your test scripts, you can use the language bindings. This is the recommended method of establishing a Local connection.

Check out enabling Local testing using language bindings to edit your test scripts.

Important: Apart from these configurations, you can set other Local options, such as, testing behind a proxy, folder testing, or using multiple local instances. Check out Introduction to Local Testing for more information.

Add browserstack.local capability to test scripts

Add the browserstack.local capability to test scripts using the following code snippets. When you set this capability to true, BrowserStack resolves the request via the Local agent running in your network.

caps.setCapability("browserstack.local", "true");
"browserstack.local" : "true",
capability.AddAdditionalCapability("browserstack.local", "true");
"browserstack.local" => "true"
"browserstack.local" : "true"
caps["browserstack.local"] = "true"
"browserstack.local" => "true"

Post these configurations, when you commit any code change, your pipeline automatically runs the test scripts as configured in the buildspec.yml file, which includes BrowserStack configurations.

You can verify if the build passed or failed by clicking Pipelines -> {your_pipeline}, and then checking the Build Details. Set variables in AWS CodePipeline

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked

Thank you for your valuable feedback

Is this page helping you?


We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked

Thank you for your valuable feedback!

Talk to an Expert
Talk to an Expert