Skip to end of metadata
Go to start of metadata


Different Machine, But Same Network

The most important thing to understand about setting up Sauce Connect is that while it doesn't need to be set up on the same machine as the site or application you're testing, it must be on the same network. Dysfunctional Sauce Connect Network Configurations illustrates some examples of network architectures in which Sauce Connect will not be able to create a tunnel, or will be too slow to carry out effective testing.  


  1. Download the appropriate version of Sauce Connect for your operating system. 

    Download LinkSHA1 Checksum
    Download Sauce Connect v4.3.13 for OS X 10.8+  d29ce847880ece5ea8c7cfa94b0c89de5a4f328c
    Download Sauce Connect v4.3.13 for Windows  ef48816793bb6142341b2a81c52b030980d35eae
    Download Sauce Connect v4.3.13 for Linux  26d1f454864de104cac04afa457eddf510c642a2
    Download Sauce Connect v4.3.13 for Linux 32-bit  5ca76dc1a4ff948d0249dc8d0e8a3d13bcc1e70b


    Installing Sauce Connect from NPM

    You can also install Sauce Connect via the NPM repository..

    npm install sauce-connect

  2. On the machine where you want to install Sauce Connect, open outbound port 443.
    Alternatively, you can configure Sauce Connect with a proxy that can reach by using the Sauce Connect command line options --proxy or --pac. See the topic Sauce Connect Proxy Configuration for more information.
  3. After extracting the Sauce Connect files onto your machine, go to the install directory and run this command.


    When you see connected, you're ready to go! 


    Finding Your Username and Access Key

    You can find your Sauce Labs username and access key in the User Profile > User Settings section of your Sauce Labs dashboard. You should also check out our topic on setting your username and access key as environment variables.


  1. Anonymous

    Would be great if sauce connect was in the npm repository.

  2. Anonymous

    It is as far as I know:

    npm install sauce-connect
    1. Anonymous

      Thanks this was just what I needed. I was looking for a quick way and clean to install saucelab connect on Codeship.

    2. Anonymous

      how to lauch it from command line after the npm install, please?

  3. Thanks, I've updated the topic with an info box.

  4. Anonymous


    I there any opportunity get to know to latest version of sauce connect sth like

    1. Not at this time but other users have asked as well at our idea portal, which can be found at the following link.

      Our product team uses the above tool to help decide what new features will be added to Sauce Labs.

    2. You can use to fetch a json dictionary with latest versions/build numbers.

      1. Anonymous

         However it shows me that current version is 4.3.12 when the latest one is 4.3.13


  5. Anonymous

    Using npm to install Sauce Connect on a Mac fails since wget is not available by default.

    1. Anonymous

      yeah just do brew install wget

  6. Anonymous

    What does this mean?

    Illegal instruction: 4

    after running: 

    1. Anonymous

      I am getting the error message too, I restart /sc and it gets working after 1 or a few retries...

      I don't remember having this issue begore upgrading to the latest version of SC.

      we are using 2 tunnels within the same account, I dont see how it might be related but so far its the only thing I see (other that upgrading to 4.3.12 recently)

  7. Anonymous

    Hi. Can you please tell me what does error code 8 mean? Thanks a lot.

  8. Hi all, if you're having difficulties with setting up Sauce Connect, you should either file a support ticket, or post a question in our support forums: We generally prefer to reserve the docs comments for correcting or clarifying the docs, but we will also use your comments to iterate over our Troubleshooting Sauce Connect topic.

  9. Anonymous

    Hi, where can I find the Sauce Connect Changelog please? Thank you!

  10. Anonymous

    It looks like the npm package has moved? Please update to `npm install sauce-connect-launcher`

  11. Anonymous

    +1 to updating the package name to sauce-connect-launcher


Write a comment…