Installation

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

What You’ll Need#

  • Review Sauce Connect basics.
  • Review System Requirements. Includes information about deployment options.
  • 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 tab.
    2. Under the header Allow apps downloaded from, select the option App Store and identified developers.

Downloading Sauce Connect Proxy#

  1. Click the one of the links below (Windows, Mac OS X, or Linux) to download Sauce Connect to your local machine. Latest Version: 4.6.4.
Sauce Connect Proxy Download LinkSHA1 Checksum
Download Sauce Connect v4.6.4 for Mac OS 10.8+dd1a04ef3c095cc2bdcedd31a3a3a469d8d382e1
Download Sauce Connect v4.6.4 for Windows 7+9142b9692852cf43e7877ad250d4bf47cb0c6547
Download Sauce Connect v4.6.4 for Linux992e2cb0d91e54b27a4f5bbd2049f3b774718115
Download Sauce Connect v4.6.4 for Linux 32-bitbd26829205a11026714e2c1b29c067dd2ced538e
  1. Extract contents of the .zip or .gz download.

  2. Open the download folder (e.g., sc-4.6.4-osx). You'll find the following contents:

    Sauce Connect download file contents
  • bin directory
    • sc.exe: Sauce Connect Proxy client executable file
  • config_examples directory
    • config.yml file: An example configuration file to be used with the --config-file command-line option. See Sauce Connect Proxy Command-Line Reference for more information.
    • systemd directory: Contains sample files for use with the systemd service manager to start and stop Sauce Connect Proxy. Consult the config_examples > systemd > README.md file for more information.
    • upstart directory: Contains sample files for use with the upstart service manager to start and stop Sauce Connect Proxy. Consult the config_examples > upstart > README.md file for more information.
  • COPYRIGHT.md file
    • Sauce Connect Open Source Software Declaration.
  • license.html file
    • Sauce Labs, Inc. End User Agreement.

Sauce Connect Proxy Logs#

Once you've started using Sauce Connect, a log file called sc.log will populate in your computer's directory.

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

OSDirectory
Mac OS X

(DD Month) (Time)

Log file:

/var/folders/72/tjnr5_fs4fvcb3csfjx4sw200000gn/T/sc.log

Linux (tested on Ubuntu 16.04.6)

(DD Month) (Time)

Log file:

/tmp/sc.log

Windows

(DD Month) (Time)

Log file:

C:\Users\sauce_username\Downloads\sc-4.5.1-win32\sc-4.5.1-win32\sc.log

Changelog#

See Sauce Connect Proxy Changelog.

Additional Resources#

NOTE: Effective with Sauce Connect Proxy version 4.6.0, we've enabled support for Public Certificates and deprecated support for Private Certificates. See Sauce Connect Proxy Changelog for more detailed information.

Last updated on by Laura Thomas