Technical Requirements

Bandwidth requirements for Kaleyra Video

The video quality is auto-adaptive based on the network congestion and available bandwidth. The following table provides the maximum usage of the bandwidth, as well as the required minimum speeds for the usage of our services:

Call typeMax bandwidth required per stream upload and download
Audio50 Kbit/s
Audio upgradable100 Kbit/s
Video 720p3500 Kbit/s
Call typeMin bandwidth required per stream upload and download
Audio50 Kbit/s
Audio upgradable100 Kbit/s
Video Basic Quality150 Kbit/s
Video Low Quality300 Kbit/s
Video Good Quality600 Kbit/s
Video HD Quality (720p)1500 Kbit/s

For example, audio call between 2 people for 1 minute = 50 Kbit/s × 2 stream × 60 seconds = 6000 Kbit per minute = 0,75 MB every minute.

Compatibility

SDK versions on mobile

  • iOS SDK requires at least iOS 10.0 at compile time and iOS 12.0 at runtime.
  • Android SDK requires at least API level 21 (Android 5.0 Lollipop).

Supported browsers

On desktop:

  • Google Chrome v72+
  • Mozilla Firefox v66+
  • Microsoft Edge (Chromium-based) v79+
  • Safari v12+

On iOS:

  • Safari v12+

On Android:

  • Google Chrome v72+
  • Mozilla Firefox v66+

Network Requirements

This section includes all the information that is required for Kaleyra Video to function properly in your environment.

Kaleyra Video uses WebRTC technology to establish audio/video connections. In a corporate network, there can be various elements that can hinder the success of a call such as Firewalls, Proxy, ISP, and many more.

To overcome these problems, Kaleyra Video uses the STUN protocol. The STUN protocol usually finds its own solution.

Using the STUN protocol, the call quality can be severely affected by the elements mentioned previously. Therefore, based on the precautions, it significantly improves the user experience without compromising the security of the perimeter.

Following are the basic requirements and a series of additional requirements for Kaleyra Video:

Basic Requirements

  • Whitelist domains *.bandyer.com, *.kaleyra.com and all subdomains.
  • The client must be able to reach any IP address on TCP port 443.
  • STUN-type packets must not be filtered by firewalls and/or any device acting on the application layer.

Additional Requirements

Optimal quality

No restrictions are applied to outgoing UDP traffic between port 30000 and port 65535.

It allows you to establish a direct connection with the other partner or Kaleyra server without going through intermediate endpoints.

High quality (highly recommended)

UDP port 3478 must be open to the addresses listed in the following tables. It allows you to establish a connection from the client to the intermediate relay servers which guarantees a much lower latency than the TCP protocol, which is generally not recommended for any real-time application.

Since most of the calls are established in P2P, it is impossible to predict a list of IPs that should be opened in the firewall, but there is a compromise that can be used.

If the platform fails to open a direct connection with the other partner, it will try to pass through an intermediate geolocated server as close as possible to the interlocutor, of which Kaleyra can provide you with the range of IP addresses.

For companies located in the EU and UK, use the following IPs:

LocationIPs
Kaleyra_0152.19.147.149
54.194.200.215
3.250.246.57
54.78.73.118
34.255.45.195

For companies located outside the EU and UK, use the following IPs:

LocationIP ranges:
Australia13.210.2.128 - 13.210.2.159, 54.252.254.64 - 54.252.254.127, 3.25.42.128 - 3.25.42.255
Brazil18.231.105.32 - 18.231.105.63, 177.71.206.192 - 177.71.206.255, 18.230.125.0 - 18.230.125.127
Germany52.59.186.0 - 52.59.186.31, 18.195.48.224 - 18.195.48.255, 18.156.18.128 - 18.156.18.255
India52.66.193.96 - 52.66.193.127, 52.66.194.0 - 52.66.194.63, 3.7.35.128 - 3.7.35.255
Ireland52.215.253.0 - 52.215.253.63, 54.171.127.192 - 54.171.127.255, 52.215.127.0 - 52.215.127.255, 3.249.63.128 - 3.249.63.255
Japan13.115.244.0 - 13.115.244.31, 54.65.63.192 - 54.65.63.255, 18.180.220.128 - 18.180.220.255
Singapore13.229.255.0 - 13.229.255.31, 54.169.127.128 - 54.169.127.191, 18.141.157.128 - 18.141.157.255
US East Coast34.203.254.0 - 34.203.254.255, 54.172.60.0 - 54.172.61.255, 34.203.250.0 - 34.203.251.255, 3.235.111.128 - 3.235.111.255
US West Coast34.216.110.128 - 34.216.110.159, 54.244.51.0 - 54.244.51.255, 44.234.69.0 - 44.234.69.127

Minimum Quality

Kaleyra Video is generally able to establish a video connection even without the recommended optional measures but, in most cases, being behind corporate firewalls, communications do not reflect the true potential and quality of the service offered. For these reasons, it is advisable to follow at least the recommended measures.

For more information related to Network troubleshooting, see Troubleshooting.