# Selenium with C#

Your guide to running tests using C# SDK on BrowserStack’s Selenium Grid of 3000+ real devices and desktop browsers.

This section covers running your first build with BrowserStack’s sample repo. To run builds with your existing test suite(s), skip to [integrate your test suite](/content/docs/automate/selenium/getting-started/integrate-your-tests/index.html).

#### Onboard faster with Test Companion

Launch in your IDE. Chat with the AI assistant to configure and run your first build instantly.

## Prerequisites

BrowserStack Username and Access key. You can find this in your [account profile](/content/accounts/profile/details/index.html) section. If you do not have an account yet, sign up for a [Free Trial](/content/users/sign_up/index.html).

## Run a sample build

Run a sample C# test build, which is based on the NUnit, using your preferred method on BrowserStack:

- [Visual Studio](/content/docs/automate/selenium/getting-started/c-sharp#Visual_Studio/index.html)
- [CLI](/content/docs/automate/selenium/getting-started/c-sharp#CLI/index.html)

### Get sample project

Get our sample project by following these steps:

#### Download project

[Download ZIP](https://github.com/browserstack/nunit-browserstack/archive/refs/heads/master.zip)

After downloading the sample project, unzip it in a desired location.

#### Import the downloaded project

Click **File** > **Open**. Navigate to your project and open it.

### Configure your browserstack.yml config file

The `browserstack.yml` file holds all the required capabilities to run your tests on BrowserStack.

#### Set access credentials

Set `userName` and `accessKey` parameters in the `browserstack.yml` file, available in the root directory, to authenticate your tests on BrowserStack.

#### Select desktop browsers or real devices from a list of 3000+ available combinations:

Parallel thread

#1  
Windows 10
Chrome 120

Parallel thread

#2  
OS X Monterey
Safari 15.6

Parallel thread

#3  
iOS 15
iPhone 13

#### Configure AI Agents

You can enable the following AI agents by adding the respective configurations in your `browserstack.yml` file:

Enable Self Heal Agent

Auto-fix locator failures with the AI-powered self-heal agent and get up to 40% fewer locator failures. [Learn more](/content/docs/automate/selenium/self-healing/index.html)

True  
False

Test Failure Analysis Agent

Auto-enabled

AI-powered root cause analysis for test failures that can reduce debugging time. [Learn more](/content/docs/test-reporting-and-analytics/agents/test-failure-analysis/index.html)

#### Update the browserstack.yml config file

Replace the `platforms` object in the `browserstack.yml` file.

```yml
userName: YOUR_USERNAME
accessKey: YOUR_ACCESS_KEY
platforms:
- YOUR_FIRST_OS_TYPE: YOUR_FIRST_OS
  YOUR_FIRST_OS_VERSION_TYPE: YOUR_FIRST_OS_VERSION
  YOUR_FIRST_BROWSER_TYPE: YOUR_FIRST_BROWSER
  YOUR_FIRST_BROWSER_VERSION_TYPE: YOUR_FIRST_BROWSER_VERSION
- YOUR_SECOND_OS_TYPE: YOUR_SECOND_OS
  YOUR_SECOND_OS_VERSION_TYPE: YOUR_SECOND_OS_VERSION
  YOUR_SECOND_BROWSER_TYPE: YOUR_SECOND_BROWSER
  YOUR_SECOND_BROWSER_VERSION_TYPE: YOUR_SECOND_BROWSER_VERSION
- YOUR_THIRD_OS_TYPE: YOUR_THIRD_OS
  YOUR_THIRD_OS_VERSION_TYPE: YOUR_THIRD_OS_VERSION
  YOUR_THIRD_BROWSER_TYPE: YOUR_THIRD_BROWSER
  YOUR_THIRD_BROWSER_VERSION_TYPE: YOUR_THIRD_BROWSER_VERSION
browserstackLocal: true
buildName: browserstack-build-1
projectName: BrowserStack Sample
selfHeal: YOUR_SELF_HEAL
```

### Run sample tests on BrowserStack!

Follow these steps to run your test on BrowserStack.

On the Visual Studio toolbar, select **Test** > **Test Explorer**.

Right-click on your test and click **Run**.

### Get sample project

Get our sample project using one of the following options.

#### Option 1: Download the project

[Download ZIP](https://github.com/browserstack/nunit-browserstack/archive/refs/heads/master.zip)

#### Option 2: Clone the Git repository

Clone our sample Git repository using these commands.

```bash
git clone https://github.com/browserstack/nunit-browserstack
cd nunit-browserstack
dotnet build
```

### Run sample tests on BrowserStack!

Use the given command to run sample tests on BrowserStack.

```bash
dotnet test --filter "Category=sample-test"
```

After you run your test, visit the [Automate dashboard](https://automate.browserstack.com/) to view your test results.

## Next steps

After you have successfully run your first test on BrowserStack, try [integrating your test suite with BrowserStack](/content/docs/automate/selenium/getting-started/integrate-your-tests/index.html).