Skip to main content

Installation

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

What You’ll Need#

  • A Sauce Labs account (Log in or sign up for a free trial license).
  • For macOS Catalina 10.15+ compatibility, enable your Mac to allow apps from the App Store and identified developers.
    1. Go to System Preferences > Security & Privacy > General.
    2. Under the header Allow apps downloaded from, select the option App Store and identified developers.

Download Latest Version#

Click the one of the links below (Linux, Mac, or Windows) to download Sauce Connect Proxy to your local machine. Download the Sauce Connect Proxy client to your local machine by clicking the link below specific to your operating system.

Latest Version: Fetching data, please wait...

PlatformDownload URLSHA1 Checksum

For version information, see Sauce Connect Proxy Changelog.

Installation#

Mac and Windows#

  1. Extract the contents of the .zip download.

  2. Open the download folder. You'll see the following contents:

    Sauce Connect download file contents
    FileDescription
    sc (Mac) / sc.exe (Windows)Sauce Connect client executable file.
    config.ymlYAML configuration file template for use with the --config-file command-line option.
    README.md, sc.service, sc@.serviceCollection of sample files for use with the systemd service manager to start and stop Sauce Connect Proxy. Consult the README.md for more information.
    COPYRIGHT.mdSauce Connect Open Source Software Declaration.
    license.htmlSauce Labs, Inc. End User Agreement.

Linux#

To install and extract Sauce Connect on Linux, add sc to your system PATH:

cd $HOMEcurl -LO https://saucelabs.com/downloads/sc-4.7.1-linux.tar.gztar xvf ./sc-4.7.1-linux.tar.gzexport PATH="$HOME/sc-4.7.1-linux/bin:$PATH"

Log File#

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

For anonymous tunnels, a log file name would be sc.log, for named tunnels, a 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-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
4.74.7.1See DownloadingJune 31, 2022
4.7.0*Linux, Mac
Security & Major Bug Fixes only
4.64.6.5Linux, 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.6.0**
Unsupported
4.5**4.5.4March 31, 2021
4.5.3
4.5.2
4.5.1
4.5.0
*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#

  • [Sauce Connect Proxy Architecture]
  • [Sauce Connect Proxy CLI Reference]