# Requirements
The following documentation details the minimum requirements necessary for using various parts of Esper.
# Web-Based Console (*.esper.cloud)
The Console requires Chrome (opens new window) v80 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.
# Firewall Requirements
| FQDNs | Ports | Features |
|---|---|---|
| *.amazonaws.com | 443 and 8883 | For provisioning, app management and device management |
| mqtt.shoonyacloud.com:1883 (opens new window) | Backup device managemnt channel | |
| mqtt2.shoonyacloud.com | 1883 | Backup device managemnt channel |
| services.shoonyacloud.com (opens new window) | TCP: 80 (HTTP), 443 (HTTPS) | IMEI/ Seamless provisioning and remote viewer APK |
| turn.shoonyacloud.com (opens new window) | "TCP: 3478, 5349 | For remote viewer and control |
| dpcdownloads.esper.cloud | UDP: 3478, 5349, 49152 - 65535" | For the 6-tap QR code method of provisioning and Remote viewer APK |
| [customer endpoint].esper.cloud | N/A | For Esper Console |
| [customer endpoint]-api.esper.cloud | TCP: 443 | For communication from device to cloud (device status event and command success/failure) |
| mqtt-telemetry-prod.esper.cloud | 1883 | Deep telemetry from devices |
| firebaseinstallations.googleapis.com and fcm.googleapis.com | 1883 | Backup channel and used for ping command to wakeup a device (Only for GMS devices) |
Note: For static IP, please contact Esper team (opens new window).
# 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 (opens new window).
| 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.