Skip to end of metadata
Go to start of metadata

It's very easy to get your existing Python tests up and running on Sauce. 

Set Sauce URL and Access Credentials

If you wanted to run a Selenium test on Selenium locally, you would initiate a driver for the browser you want to test against like this.

Running a Local Python Test
driver = webdriver.Firefox() 

To run a test on a remote service like Sauce Labs, all you need to change is your driver definition, make sure that the sauce_endpoint variable includes your Sauce USERNAME and ACCESSKEY, and then pass it two parameters: command_executor, which points to the Sauce cloud and uses your Sauce Labs authentication to log in, and desired_capabilties, which specifies the browsers and operating systems to run the tests against.

Running a Python Test Remotely on Sauce
# this is how you set up a test to run on Sauce Labs
desired_cap = {
    'platform': "Mac OS X 10.9",
    'browserName': "chrome",
    'version': "31",
username = os.environ['SAUCE_USERNAME']
access_key = os.environ['SAUCE_ACCESS_KEY']
driver = webdriver.Remote(
    command_executor='https://{}:{}'.format(username, access_key),

To find your Sauce Labs access key:

  1. Sign in to with the username you set up when you created your account. 
    You will use this same username in your test script. 
  2. To find your access key:
    1. Click your name in the Account Profile menu in the upper-right corner.
    2. Click User Settings.
    3. Scroll down to Access Key and click Show.
    4. Enter the password you use to sign in to Sauce Labs to view the access key.
    5. Click the Copy icon.

IP Ranges and Data Center Endpoints
Sauce Labs has data centers in both the US and EU. You can access Sauce Labs services from either location by providing the appropriate URL endpoints, and whitelisting their associated IP ranges. 

 Click here to view US Data Center Endpoints

Virtual Device Cloud

Sauce Connect Proxy (do not need to specify, Sauce Connect Proxy will use this by default)


  • for Signing/Encryption Certificate
  • for Entity AssertionConsumeURL


  • Virtual Devices and Desktops:
  • Real Devices:

IP Ranges: (this is equivalent to the range – (this is equivalent to the range -

 Click here to view EU Data Center endpoints

For more information, including framework configuration for the European data center, check out Sauce Labs European Data Center Configuration Information.

Virtual Device Cloud

Sauce Connect Proxy (specify with -x argument)


  • for Signing/Encryption Certificate
  • for Entity AssertionConsumeURL


IP Range: (this is equivalent to the range -

Set Desired Capabilities

Once you have your tests set up to run in the Sauce cloud, you need to define the platform, browser, and version you want the test to run against, which is where desired capabilities come into play. 

desired_cap = {
    'platform': "Mac OS X 10.9",
    'browserName': "chrome",
    'version': "31",

You can manually enter the values you want for platformbrowsername, and version, or you can use the handy Platform Configurator to generate the desired_caps values for any combination of platform, browser, and browser version. 

  • No labels