Sauce Connect Proxy 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).
- Review Sauce Connect Proxy System and Network Requirements.
Running the Sauce Connect Proxy Client#
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...
Platform Download URL SHA1 Checksum For version information, see Sauce Connect Proxy Changelog.
- 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:
File Description sc (Mac) / sc.exe (Windows) Sauce Connect client executable file. config.yml Sauce Connect Proxy YAML configuration file template. sc.service, sc@.service Sample files intended for use with the systemd service manager, an alternative way to start and stop Sauce Connect Proxy tunnels. Consult the README.md for more information. COPYRIGHT.md Sauce Connect Open Source Software Declaration. license.html Sauce Labs, Inc. End User Agreement.
- If you're using Linux, you'll need to add Sauce Connect 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"
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.
| OS | Log 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.
| Family | Version | Download Link | End of Life |
| Full Support | |||
| 4.7 | 4.7.1 | See Linux, Mac, Windows | June 31, 2022 |
| 4.7.0* | Linux, Mac | ||
| Security & Major Bug Fixes only | |||
| 4.6 | 4.6.5 | Linux, Mac, Windows | Jan. 31, 2022 |
| 4.6.4 | Linux, Mac, Windows | ||
| 4.6.3 | Linux, Mac, Windows | ||
| 4.6.2 | Linux, Mac, Windows | ||
| 4.6.1 | Linux, Mac, Windows | ||
| 4.6.0** | — | ||
| Unsupported | |||
| 4.5** | 4.5.4 | — | March 31, 2021 |
| 4.5.3 | — | ||
| 4.5.2 | — | ||
| 4.5.1 | — | ||
| 4.5.0 | — | ||