Skip to main content

Sauce Connect Proxy Installation

This topic describes where and how to download Sauce Connect Proxy to your local machine.

What You’ll Need#

Running the Sauce Connect Proxy Client#

  1. Download the latest Sauce Connect Proxy client to your local machine by clicking the link below corresponding to your OS. If applicable, delete any previous versions you have. Using older versions may impact your ability to launch a tunnel or cause other technical issues.

    Latest Version: Fetching data, please wait...

    PlatformDownload URLSHA1 Checksum

    For version information, see Sauce Connect Proxy Changelog.

  1. Extract the contents of the .zip download to your local machine. For easy access, we recommend saving the Sauce Connect Proxy folder to your home directory. The folder contains the following:
    Sauce Connect download file contents
    sc (Mac) / sc.exe (Windows)Sauce Connect client executable file.
    config.ymlSauce Connect Proxy YAML configuration file template.
    sc.service, sc@.serviceSample files intended for use with the systemd service manager, an alternative way to start and stop Sauce Connect Proxy tunnels. Consult the for more information.
    COPYRIGHT.mdSauce Connect Open Source Software Declaration.
    license.htmlSauce Labs, Inc. End User Agreement.
  1. If you're using Linux, you'll need to add Sauce Connect to your system PATH:
    cd $HOMEcurl -LO xvf ./sc-4.7.1-linux.tar.gzexport PATH="$HOME/sc-4.7.1-linux/bin:$PATH"
Next Steps

See the Sauce Connect Proxy Quickstart to learn how to start a basic tunnel.

Running Sauce Connect in Docker#

As an alternative to downloading the client, you can use the Sauce Connect Proxy Docker image to run it in a Docker container. To learn more, see Sauce Connect Docker Container Setup.

Log File#

Once you've started using Sauce Connect Proxy, a log file will appear in your computer's directory. The log file name depends on whether --tunnel-name was used.

For anonymous (unnamed) tunnels, the log file name will be sc.log. For named tunnels, the log file name would be sc-{tunnel_name}.log.

The location of the log file will vary, depending on your operating system. For Mac and Linux, the sc.log will use a tmp folder. For Windows, it'll use the current working directory.

OSLog Directory
Mac(DD Month) (Time) Log file:/var/folders/72/tjnr5_fs4fvcb3csfjx4sw200000gn/T/sc-TUNNEL_NAME.log
Linux(DD Month) (Time) Log file:/tmp/sc-TUNNEL_NAME.log
Windows(DD Month) (Time) Log file:C:\Users\sauce_username\Downloads\sc-4.7.1-win32\sc-TUNNEL_NAME.log

Version Lifecycle Information#

The launch of Sauce Connect 4.7.1 makes it the officially supported version of the Sauce Connect client. All previous versions are in maintenance mode, with the oldest versions nearing the end of their support life.

FamilyVersionDownload LinkEnd of Life
Full Support Linux, Mac, WindowsJune 31, 2022
4.7.0*Linux, Mac
Security & Major Bug Fixes only, Mac, WindowsJan. 31, 2022
4.6.4Linux, Mac, Windows
4.6.3Linux, Mac, Windows
4.6.2Linux, Mac, Windows
4.6.1Linux, Mac, Windows
4.5**4.5.4March 31, 2021
*Windows version no longer available for download.#
**Sauce Connect Proxy versions below 4.6.1, which were supporting Private Certificates, reached end of life and are no longer available for download.#

More Information#