Sauce Connect Proxy 5 release is currently in the Beta stage, some changes are expected. Real Devices are not currently supported but support is expected Q4 '23 at the earliest.
Sauce Connect Proxy 5 is a complete rewrite of Sauce Connect Proxy 4.x.x that aims to improve observability, performance, and user experience and provide a strong foundation for future improvements.
What You'll Need
- If you're new to Sauce Connect, we recommend reviewing the Sauce Connect Proxy overview documentation.
What's New In Sauce Connect Proxy 5?
The Sauce Connect Proxy version 5 major release introduces CLI changes. Please refer to Sauce Connect Proxy 5 CLI Reference for details.
- Improved onboarding and integration due to the secure connection (tunnel) protocol change. The previous generation of Sauce Connect Proxy (version 4) used a custom KGP protocol. The Sauce Connect Proxy version 5 uses HTTP/2 to establish a secure connection to Sauce Labs. Using a standard well-documented protocol that is widely used in the industry simplifies Sauce Connect Proxy integration in secure CI/CD environments.
- Performance improvement. HTTP/2 protocol is optimized for security and performance, it provides significant performance improvements that are especially noticeable when multiple test sessions use the same Sauce Connect Proxy instance.
- Significant improvement in CPU and memory utilization. Sauce Connect Proxy 5 utilizes much less memory and CPU resources making it easier to run at scale.
- Observability improvement. Sauce Connect Proxy 5 comes with Prometheus metrics. A sample Grafana dashboard is available here.
- Easier installation and upgrade process. Sauce Connect Proxy 5 release contains deb and rpm packages for Linux, brew support for macOS, as well as x86_64 and arm64 architectures support for all platforms.
- Secure WebSocket support with SSL Certificate Bumping enabled.
- SOCKS5 support for upstream proxies.
Sauce Connect Proxy 5 major changes are listed below.
- Tunnels must be named, the
--tunnel-nameflag is no longer optional. It's done to improve security and usability - tests that use Sauce Connect must explicitly specify the tunnel name.
- There is no default Sauce Labs region value,
--regionis required to ensure that the correct region is explicitly specified.
- Proxy auto-detection is not supported, all proxies must be specified with explicit flags -
--pacfor SUT requests and
--proxy-saucefor Sauce Labs REST API and tunnel connections.
- Domain flags (
--direct-domains, etc) accept regular expressions only.
- Subcommands are introduced to support multiple CLI changes and future capabilities.
- The Selenium Relay feature is not supported.
- Log administration capabilities (such as log-rotate) are not supported. Log management is better left to specialized tools.
Getting Started With Sauce Connect Proxy 5
Sauce Connect Proxy 5 network requirements are very similar to the previous generation of Sauce Connect Proxy (version 4). See this document for quickstart instructions.
- Sauce Connect Proxy 5 doesn't initiate non-HTTP connections.
- Additional proxies setup is different between Sauce Connect Proxy 4.x.x and 5.x.x.