Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Flag (Short)Flag (Long)

Description

-u

Anchor
--user
--user
--user
<username>
You can also use the environment variable SAUCE_USERNAME
-k
Anchor
--api-key
--api-key
--
api-key <api-key>
You can also use the environment variable SAUCE_ACCESS_KEY
-B
Anchor
--no-ssl-bump-domains
--no-ssl-bump-domains
--no-ssl-bump-domains <...>

Comma-separated list of domains. Requests including hosts that matches one of these domains will not be SSL re-encrypted. See the section on SSL Bumping Enabled by Default in the Troubleshooting Sauce Connect topic for more information about situations in which you would want to use this command.

Tip
titleFormatting Domains
  • Make sure your comma-separated list of domains doesn't include any spaces. For example, mydomain.com,saucelabs.com,mysite.com, instead of mydomain.com, saucelabs.com, mysite.com
  • Use only the domain name, you don't need to precede it with http: or https:
  • You can use an asterisk as a wild-card character to refer to a set of URLS associated with the same sub-domain. For example, you could refer to both wiki.saucelabs.com and my.saucelabs.com with *.saucelabs.com.
  • If you don't want any domains to be SSL re-encrypted, you can specify all with the argument(i.e. -B all or --no-ssl-bump-domains all)
Note

HTTP Header Injection is disabled for all HTTPS domains passed to --no-ssl-bump-domains argument.

-N
Anchor
--no-proxy-caching
--no-proxy-caching
--no-proxy-caching

Disable caching in Sauce Connect. All requests will be sent through the tunnel.

-M
Anchor
--max-missed-acks
--max-missed-acks
--max-missed-acks <...>

The maximum amount of keepalive acks that can be missed before the client will trigger a reconnect. (The default : is 30).

-D
Anchor
--direct-domains
--direct-domains
--direct-domains <...>

Comma-separated list of domains. Requests including hosts that matches one of these domains will be relayed directly through the Internet, instead of through the Sauce Connect tunnel.

Tip
titleFormatting Domains
  • Make sure your comma-separated list of domains doesn't include any spaces. For example, mydomain.com,saucelabs.com,mysite.com, instead of mydomain.com, saucelabs.com, mysite.com
  • Use only the domain name, you don't need to precede it with http: or https:
  • You can use an asterisk as a wild-card character to refer to a set of URLS associated with the same sub-domain. For example, you could refer to both wiki.saucelabs.com and my.saucelabs.com with *.saucelabs.com.


-t
Anchor
--tunnel-domains
--tunnel-domains
--tunnel-domains <...>

Inverse of --direct-domains. Overrides --direct-domains. Only requests for domains in this list will be sent through the Sauce Connect tunnel.

Tip
titleFormatting Domains
  • Make sure your comma-separated list of domains doesn't include any spaces. For example, mydomain.com,saucelabs.com,mysite.com, instead of mydomain.com, saucelabs.com, mysite.com
  • Use only the domain name, you don't need to precede it with http: or https:
  • You can use an asterisk as a wild-card character to refer to a set of URLS associated with the same sub-domain. For example, you could refer to both wiki.saucelabs.com and my.saucelabs.com with *.saucelabs.com.


-v
Anchor
--verbose
--verbose
--verbose

Enable verbose debugging. -vv will output HTTP headers and KGP logs. From version 4.4.3, -v will also output HTTP headers.

Warning

Running sc Sauce Connect Proxy with the very verbose -vv option is system-resource demanding and adversely affects sc proxy will adversely affect Sauce Connect Proxy performance. This option is meant for troubleshooting only, not for long-term use.


-F
Anchor
--fast-fail-regexps
--fast-fail-regexps
--fast-fail-regexps <...>

Comma-separated list of regular expressions. Requests with URLs matching one of these will get dropped instantly and will not go through the tunnel. See the question How Do I Use Sauce Connect to Test Graceful Degradation in the Sauce Connect FAQs for an example of how you would use this command to test for application or site degradation based on missing assets or resources.

-i
Anchor
--tunnel-identifier
--tunnel-identifier
--tunnel-identifier <id>

Assign <id> to this Sauce Connect instance. Future jobs will use this tunnel only when explicitly specified by the tunnel-identifier DesiredCapability in a Selenium client. Check out the topic Using Multiple Sauce Connect Tunnels for information on using tunnel-identifier to run multiple Sauce Connect tunnels simultaneously. Test Configuration Options contains more information about the syntax for setting tunnel-identifier as a DesiredCapability.

-l
Anchor
--logfile
--logfile
--logfile <file>

Capture the Sauce Connect logs in <file>. If a path is not specified in <file>, the default location of the <file> is the same location where the Sauce Connect executable can be found on your machine.

-P
Anchor
--se-port
--se-port
--se-port <port>

Port on which Sauce Connect's Selenium relay will listen for requests. Selenium commands reaching Sauce Connect on this port will be relayed to Sauce Labs securely and reliably through Sauce Connect's tunnel. Defaults to 4445.

-p
Anchor
--proxy
--proxy
--proxy <host:port>

Proxy host and port that Sauce Connect should use to connect to the Sauce Labs cloud. See Sauce Connect Proxy with an Additional Proxy Setup for more information about using Sauce Connect with proxies.

-w
Anchor
--proxy-userpwd
--proxy-userpwd
--proxy-userpwd <user:pwd>

Username and password required to access the proxy configured with -p. See   Sauce Connect Proxy with an Additional Proxy Setup for more information about using Sauce Connect with proxies.

 
Anchor
--pac
--pac
--pac <url>

Proxy autoconfiguration. Can be a http(s) or local file:// URL. See  Sauce Connect Proxy with an Additional Proxy Setup for more information about using Sauce Connect with proxies.

Note

Absolute paths are required when specifying a local PAC file (EG. file:///Users/Andrew/Desktop/MyPac.pac).

-T
Anchor
--proxy-tunnel
--proxy-tunnel
--proxy-tunnel

Use the proxy configured with -p for the tunnel connection.See  Sauce Connect Proxy with an Additional Proxy Setup for more information about using Sauce Connect with proxies.

-s
Anchor
--shared-tunnel
--shared-tunnel
--shared-tunnel

Allows sub-accounts of the tunnel owner to use the tunnel. See the question Can I Reuse a Tunnel Between Multiple Accounts? in the Sauce Connect FAQs for more information on using this command.

-x
Anchor
--rest-url
--rest-url
--rest-url <arg>

Advanced feature: Connect to SauceREST API at alternative URL. Use only if directed to do so by Sauce Labs support.

-f
Anchor
--readyfile
--readyfile
--readyfile

File that will be touched to indicate when the tunnel is ready.

-a
Anchor
--auth
--auth
--auth <host:port:user:pwd>

Perform basic authentication when a URL on <host:port> asks for a username and password. This option can be used multiple times. Using --auth with Sauce Connect Proxy includes an example.

Note
HTTP Header Injection is disabled for SSL domains that are not re-encrypted by Sauce Connect, which means performing basic authentication in this way is disabled for all HTTPS domains passed to --no-ssl-bump-domains argument.
-z
Anchor
--log-stats
--log-stats
--log-stats <seconds>

Log statistics about HTTP traffic every <seconds>. Information includes bytes transmitted, requests made, and responses received.

 
Anchor
--max-logsize
--max-logsize
--max-logsize <bytes>

Rotate logfile after reaching <bytes> size. Disabled by default.

 
Anchor
--doctor
--doctor
--doctor

Perform checks to detect possible misconfiguration or problems. Check out Troubleshooting Sauce Connect Proxy with --doctor for more information about the errors that --doctor will detect and how to resolve them.

 
Anchor
--no-autodetect
--no-autodetect
--no-autodetect

Disable the autodetection of proxy settings.

 
Anchor
--version
--version
--version

Display version information and exit.

-r
Anchor
--reconnect
--reconnect
--reconnect <seconds>

Maximum time in seconds to wait between tunnel reconnect attempts.

-X
Anchor
--scproxy-port
--scproxy-port
--scproxy-port <port>

Port to use for the built-in HTTP proxy.

 
Anchor
--cainfo
--cainfo
--cainfo <cainfo file>

CA certificate bundle to use for verifying REST connections.

 
Anchor
--ca-path
--ca-path
--capath <capath dir>

Directory of CA certs to use for verifying REST connections.

 
Anchor
--no-cert-verify
--no-cert-verify
--no-cert-verify

Disable certificate verification for REST connections.

Info
titleSauce Developers Only

This flag is intended to be used by Sauce Connect developers only.

 
Anchor
--scproxy-read-limit
--scproxy-read-limit
--scproxy-read-limit <X>
Rate limit reads in scproxy to X bytes per second. This option can be used to adjust local network transfer rate in order not to overload the tunnel connection.
 
Anchor
--scproxy-write-limit
--scproxy-write-limit
--scproxy-write-limit <X>
Rate limit writes in scproxy to X bytes per second. This option can be used to adjust local network transfer rate in order not to overload the tunnel connection.
-o

Anchor
--output-config
--output-config
--output-config

Write all configuration options as JSON to stdout. This flag is used by our Jenkins plugin and is not intended to be used by end-users.
 

Anchor
--vm-version
--vm-version
--vm-version <version>

Request a specific tunnel VM version.

 

Anchor
--daemonize
--daemonize
--daemonize

Go into the background after starting up.

Note
titleDepreciated in 4.4.0

--daemonize is deprecated in Sauce Connect Proxy from version 4.4.0 onwards. This KB article in the Sauce Labs support portal has more information:

https://support.saucelabs.com/hc/en-us/articles/115002314128-No-daemonize-Option-in-Sauce-Connect-Proxy-4-4-0

 

Anchor
--dns
--dns
--dns <server[,server..]>

Use specified name server. To specify multiple servers, separate them with a comma. Use IP addresses, optionally with a port number, the two separated by a colon. Example: --dns 8.8.8.8,8.8.4.4:53
 

Anchor
--no-remove-colliding-tunnels
--no-remove-colliding-tunnels
--no-remove-colliding-tunnels

Don't remove identified tunnels with the same name, or any other default tunnels if this is a default tunnel. Jobs will be distributed between these tunnels, enabling load balancing and high availability. By default, colliding tunnels will be removed when Sauce Connect is starting up.

 

Anchor
--wait-tunnel-shutdown
--wait-tunnel-shutdown
--wait-tunnel-shutdown

When shutting down, wait for all active jobs using the tunnel to finish. By default, Sauce Connect will force the shutdown of the tunnel even when there are active jobs.

Note
titleDeprecated in 4.4.5

--wait-tunnel-shutdown is deprecated in Sauce Connect Proxy from version 4.4.5 onwards. Going forward, the behavior will be that tunnels wait for all tests to complete before shutting down the tunnel.

-d

Anchor
--pidfile
--pidfile
--pidfile <file>

File to write Sauce Connect's process ID into. Useful for programmatically stopping Sauce Connect.

Note

Sauce Connect Proxy makes a best effort but cannot guarantee that the pidfile will be removed when shutting down Sauce Connect Proxy. With that in mind, relying on the pidfile as a means to monitor Sauce Connect Proxy is not supported.

 

Anchor
--metrics-address
--metrics-address
--metrics-address=address

host:port for the internal web server used to expose client side metrics. (default: localhost:8888)

-h

Anchor
--help
--help
--help

Display the help text.

 

Anchor
--extra-info
--extra-info
--extra-info '{"inject_job_id": true}'

Injects job id and tunnel id as HTTP request headers.

Note

HTTP Header Injection is disabled for SSL domains that are not re-encrypted by Sauce Connect, in otherwords Header Injection is disabled for all HTTPS domains passed to --no-ssl-bump-domains argument.