AWS Device Farm
Developer Guide (API Version 2015-06-23)

Use a Remote Access Session in AWS Device Farm

For information about sessions, see Sessions.


  • Create a session. Follow the instructions in Create a Session, and then return to this page.

Use a Session in the Device Farm Console

As soon the device you requested for a remote access session becomes available, the console displays the device screen. The session has a maximum length of 60 minutes. The time remaining in the session appears below the menu bar on the right side of the console.

Installing an Application

To install an application on the session device, in Install applications, choose Upload, and then choose either the .apk file (Android) or the .ipa file (iOS) you want to install. Applications you run in a remote access session don't require any test instrumentation or provisioning.


AWS Device Farm does not display a confirmation after an app is installed. Try interacting with the app icon to see if the app is ready to use.

When you upload an app, there is sometimes a delay before the app is available. Look at the system tray to determine whether the app is available.

Controlling the Device

You can interact with the device displayed in the console as you would the actual physical device, by using your mouse for touch and the device's on-screen keyboard. For Android devices, there are buttons in View controls that function like the Home and Back buttons on an Android device. For iOS devices, there is a Home button that functions like the home button on an iOS device. You can also switch between applications running on the device by choosing Recent apps.

Switching Between Portrait and Landscape Mode

You can also switch between portrait (vertical) and landscape (horizontal) mode for the devices you are using.

Next Steps

Device Farm continues the session until you stop it manually or until the 60-minute time limit is reached. To end the session, choose Stop session. After it stops, you can access captured video and logs generated. For more information, see Get Session Results.

Tips and Tricks

You might experience performance issues with the remote access session in some regions. This is due, in part, to latency in some regions. If you experience performance issues, give the remote session a chance to catch up before interacting with the app again.