Skip to main content

Managing Private Devices


Private Devices Only

Private device management allows an organization admin to view and manage the private devices in an organization via the Private Device Management panel. These features can improve device availability and optimize manual and automation workflows.

  • Assign a private device to a team.
  • Customize a private device to allow apps, system apps, and accounts to persist between sessions.
important
  • Everyone in an organization can access a device in the the default unassigned state.
  • Only organization admins can manage private devices.
    • An organization admin can always re-assign a device to another team or set a device to the default unassigned state.
  • Only team members can access a device assigned to a team.
    • This rule is enforced for all roles!
      • i.e., to access a device, an organization admin must be a member of the team a device is assigned to.
    • Devices automcatically return to the default unassigned state if their assigned team is deleted.
note

For more information about managing teams, see Adding and Deleting Teams.

Private devices are not included in VM or RDC concurrency limits.
For more details, please see Managing Concurrency.

Viewing an Organization’s Private Devices

  1. On Sauce Labs, click ACCOUNT and then click Organization Management. Organization management navigation
  2. Click the DEVICES tab. The devices assigned to your organization will be listed. Devices tab

Assigning a Private Device to a Team

note

A device can be assigned to only 1 team at a time.

  1. On Sauce Labs, click ACCOUNT and then click Organization Management.
  2. On the DEVICES tab, in the Team dropdown, select a team to assign the device to. Assign a team

App Allow List

The device cleaning process will remove apps installed from Sauce Storage and the App Store/Play Store between sessions. To have installed apps and app data persist between sessions, update this setting for each of the application identifiers. This might be the app you are testing or dependent apps, e.g. MFA app, Microsoft Authenticator, etc.

important

This setting does NOT install the app. You must manually or via automation install the desired version of the matching app.

com.google.chrome.ios
com.apps.app1
com.ios.app2

Multiple entries must be comma-separated.

System App Allow List (iOS)

Certain iOS preinstalled apps are hidden by default, e.g. Messages, Mail, Notes. To access iOS preinstalled applications, add the bundle ID for each app.

important

For a list of native iPhone and iPad apps and their corresponding bundle IDs, please follow the reference link below.
https://support.apple.com/en-gb/guide/deployment/depece748c41/web

com.apple.MobileSMS com.apple.mobilenotes

Multiple entries must be comma-separated.

Account Allow List

Update this setting for each account email to preserve store and payment account sign-ins between sessions.

  • Google accounts signed into the Play Store/Google Pay/In-App Purchase can be preserved between sessions.
  • Apple IDs signed into the device and App Store/TestFlight/Apple Pay/In-App Purchase can be preserved between sessions.
important

account1@mydomain.com
account2@mydomain.com

Multiple entries must be comma-separated.

Retain folders/filepath (Android)

You have the option to retain specific filepaths or folders on your private Android devices between sessions. This feature ensures that selected data remains intact during the device cleaning process.

  • Filepaths or folders associated with specific applications can be retained.
  • This is especially useful for retaining data that is crucial for continuous testing or for maintaining certain app states.

By default, the following folders are not cleaned on your private Android devices, ensuring that their contents are retained between sessions (iOS/Android):

  • Documents
  • Pictures
  • Downloads
  • DCIM
note

You can only retain specific folders created inside tmp. You cannot retain the whole tmp folder. Valid: /data/local/tmp/retain Invalid path: /data/local/tmp/

important

/data/com.wavelink.velocity/files
/com.my.app/data/temp/folder

Multiple entries must be comma-separated.

Enable Apple Pay

Enable this setting to test Apple Pay. This will persist assistive touch on the device, which is required to confirm payment. Please send us a support ticket to set up Confirm with AssistiveTouch on your device. This requires manual intervention from our side.

important

This feature requires setting the Account Allow List.
Please see Testing Apple Pay for more information.