Skip to content

[Documentation] Rework Sauce Labs section to lead with Sauce Connect tunnel #1973

Closed

Description

@andreion1ca

Reworks the Sauce Labs section of the "Running tests using device cloud services" docs page so it leads with the Sauce Connect Proxy tunnel method, which supersedes the older public-VM approach.

What changed

  • New: Sauce Connect Proxy tunnel (recommended) — run AltTester® Desktop locally, start the tunnel with --proxy-localhost allow, and connect with the default AltDriver() (127.0.0.1:13000). No public VM and no rebuild-per-IP.
  • Kept: public-VM walkthrough — preserved as a secondary option (now clearly labelled).
  • Removed the stale "we are now working on Sauce Connect Tunnel Proxy … instructions shortly" note — the instructions are now here.
  • Fixed a copy-paste "BrowserStack test device" reference inside the Sauce Labs section.

Related

Activity

  1. changed the title [-]docs: rework Sauce Labs section to lead with Sauce Connect tunnel[/-] [+][Documentation] Rework Sauce Labs section to lead with Sauce Connect tunnel[/+] on Jun 15, 2026
  2. andreion1ca commented on Jun 15, 2026

    @andreion1ca
    ContributorAuthor

    Tested: Sauce Connect Proxy tunnel flow on iOS

    Environment:

    • Sauce Connect Proxy: 5.5.1
    • AltTester® Desktop: 2.3.2
    • Appium.WebDriver: 4.4.0 (matching the example project)
    • AltTester-Driver: 2.2.5
    • Device: iPhone 15 (real device, Sauce Labs eu-central-1)
    • Build: TrashCat.ipa instrumented with AltTester® Unity SDK, default connection settings (127.0.0.1:13000)
    • Test project: EXAMPLES-CSharp-Cloud-Services-AltTrashCat
      (https://github.com/alttester/EXAMPLES-CSharp-Cloud-Services-AltTrashCat/tree/saucelabs_example) (saucelabs_example branch)

    Results:

    • 71 tests discovered and executed
    • The app connected to AltTester® Desktop through the Sauce Connect tunnel as expected
    • Test failures are due to the build being made without addressables (missing game scenes/assets) — unrelated to the Sauce Labs integration
    • The tunnel, Appium session, and AltDriver connection all worked as documented

    Conclusion

    The documented Sauce Connect Proxy tunnel approach works as described. The code examples are correct for Appium.WebDriver 4.4.0.

  3. andreion1ca commented on Jun 16, 2026

    @andreion1ca
    ContributorAuthor

    Currently the examples use version Appium.WebDriver 4.4.0, which is not aligned with the latest releases. The SauceLabs documentation itself references a version greater than 8. Moving this issue back to TODO in order to address this.

  4. MihaiCuc98 commented on Jun 25, 2026

    @MihaiCuc98
    Contributor

    Tested on:

    • staging documentation

    Checks:

    1. BrowerStack → BrowserStack (line 5)

    Missing s — "with BrowerStack Local"

    1. set commands missing = (lines 85–86, 306–307, 725–727)

    Windows set command requires set VAR=value, not set VAR "value":

    • set BROWSERSTACK_USERNAME "yourUsername" → set BROWSERSTACK_USERNAME="yourUsername"
    • set BROWSERSTACK_ACCESS_KEY "yourAccessKey" → set BROWSERSTACK_ACCESS_KEY="yourAccessKey"
    • Same pattern repeated at lines 306–307 (GitHub Actions section) and lines 725–727 (SauceLabs section)
    1. <builName.ipa> → <buildName.ipa> (line 773)

    Missing d in "buildName"

    1. Backtick instead of apostrophe in dont` (lines 922, 1105, 1116, 1913)

    dont→don't` — occurs 4 times

    1. run-test.sh → run-tests.sh (lines 1458, 1905)

    The section headings consistently say run-tests.sh (with s), but the body text drops the s in two places (both in BitBar sections — C# and Python)

    1. Double double-quotes around URI (line 1684)

    new Uri(""http://localhost:4723/wd/hub"") → new Uri("http://localhost:4723/wd/hub")

    Conclusion:

    Considering the above-mentioned information, I will move the ticket to Done.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions