# Requirements
The following documentation details the minimum requirements necessary for using various parts of Esper.
# Web-Based Console (*.esper.cloud)
The Console requires Chrome v57 or above. At present, viewing the console on mobile devices is not supported.
# Dedicated Android Devices
Targeted Dedicated Devices must run Android version 4.4 KitKat (API Level 19) or above. However, we recommend that devices running Android version 7.0 Nougat (API Level 24) or above be used with Esper.
We have recently started supporting latest Android version 10 on our platform.
Esper Development Devices running Esper Enhanced Android will always be supported be used. Such devices open up additional features for developers, when using Esper.
# Esper Feature Support
# If you have any questions about what feature support we offer for your device, please contact support@esper.io
# Legend:
- ✔️ - Feature Supported
- ❌ - Feature Not Supported
- ❗️ - A prompt will be provided to the user, which then has to be approved unless a supervisor is present, in which case silent application install/uninstall is supported.
- ❓ - Partially supported. This option is only supported if a supervisor is available.
| Android 4.4 (KitKat) | Android 5.0 (Lollipop) | Android 5.1 (Lollipop MR1) | Android 6.0 (Marshmallow) | Android 7.0 (Nougat) | Android 7.1 (Nougat MR1) | Android 8.0 (Oreo) | Android 8.1 (Oreo MR1) | Android 9.0 (Pie) | Android 10.0 (Q) | |
|---|---|---|---|---|---|---|---|---|---|---|
| Managed Google Play | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| App Install/Uninstall | ❗️ | ❗️ | ❗️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| App Permission Management | ❌ | ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Remote Viewer & Screenshot | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Device Commands | ||||||||||
| Reboot | ❓ | ❓ | ❓ | ❓ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Location Control | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Brightness Control | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Volume Controls | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Rotation Control | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Screen Timeout Control | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Policy Features | ||||||||||
| Disable Lockscreen | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Disable Camera | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Disable Status Bar | ❌ | ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Disable NFC Beam | ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Disable Outgoing Calls | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Disable Factory Reset | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Disable USB Connectivity | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Disable Screenshot | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Disable Safe Mode | ❌ | ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Disable SMS | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Enforce Password Rules | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Enforce Default App Permissions | ❌ | ❌ | ❌ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Safety Net | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Device Telemetry | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| Kiosk Mode & Lockdown | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
# Infrastructure
Dedicated devices are often behind corporate firewalls, preventing the Esper backend from communicating with them (or vice-versa). Please make sure to whitelist the following URLs and Ports, in case your fleet is running behind such a firewall.
# URLs
- *.amazonaws.com
- mqtt.shoonyacloud.com:1883 (device telemetry/management)
- [customer endpoint].esper.cloud:443
- [customer-endpoint]-api.esper.cloud
- turn.shoonyacloud.com
- 13.52.132.230 (required only if want to allow secure remote ADB access to your devices)
For customers that are provisioning devices behind a firewall there are a few additional URLs to allow:
- dpcdownloads.esper.cloud
- downloads.esper.io
- services.shoonyacloud.com (only for serial number-based provisioning)
# Ports
- 5228
- 5229
- 5230
# Esper Dev Tools Requirements
Various Esper tools and SDK require a Python installation. The table below lists the requirements for Python, depending on the tool you would like to use. Python can be downloaded and installed from python.org.
| Tool | Python 2.7 | Python 3.6+ |
|---|---|---|
| Esper SDK | Yes | Yes |
| Esper CLI | Yes |
# Esper SDK Language Support
- Python
To use the Esper Python SDK, please ensure you are using Python v2.7 or above.
Note: Esper plans to release SDK support for Kotlin, Java, and JavaScript. If you are using a language other than Python and would like to start work with the Esper APIs right away, please consider calling the APIs directly. You can refer to the Esper API documentation here.
# Supported Development Platforms
- MacOS
- Windows
- Linux
At Esper, our developers use all of the above platforms to interact with Esper itself. So feel free to use whatever platform fits well for you!
# Help
If you face any issues setting up your requirements for Esper, please don't hesitate to ask for some help! We'll be happy to assist you.