Supported Platforms


iTwin.js backends are built and tested on the following:

  • Arch Linux
  • Debian 11 "Bullseye"
  • Windows 10 version 1803 (or greater)
  • MacOS 10.15 (or greater)

They should run on most Windows, Linux and MacOS versions with Tier 1 support from Node.js. However, regular testing only occurs on the platforms listed above.

Supported Node.js Versions

The following Node.js versions are officially supported by the iTwin.js backend code.

The minimum requirements are driven by Node's compatibility with a specific N-API version. iTwin.js currently requires N-API version 8. See the Node compatibility matrix for more details.

iTwin.js - Node Support iTwin.js 1.x iTwin.js 2.x iTwin.js 3.x iTwin.js 4.x
Node 20 (>=20.9) ✅ (>= 4.3)
Node 18 (>=18.12) ✅ (>= 3.5)
Node 16 (>=16.13)
Node 14 (>=14.17) ✅ (>= 2.13)
Node 12 (>=12.22)
Node 10

Backend Prerequisites

Operating System Architectures Versions Notes
Linux all GLIBC >= 2.31, GLIBCXX >= 3.4.28
Windows all Visual Studio 2017 C Runtime
macOS x64 >= 10.15
macOS arm64 >= 11 >= iTwin.js 3.3

Supported Browsers

iTwin.js strives to support as many modern browsers as possible, though it requires complete JavaScript ES6 support. The quality of the web browser's WebGL implementation has a substantial impact on display performance.

  • Chrome (recommended for development)
  • Firefox
  • Safari
  • Opera
  • "New" Chromium-based Edge

Note: Internet Explorer and "Old" Edge are not supported

Note: Other Chromium-based browsers will likely work fine, but are untested.


To enable the development of desktop applications, iTwin.js supports the latest Electron releases. As of iTwin.js 4.0, Electron 23 is the minimum requirement. See Electron platform requirements for supported Windows, Linux and MacOS versions.

Mobile Native

The following minimum versions of mobile operating systems are supported:

  • iOS 15: Minimum supported iPhones and iPads
  • Android 9.0 (API Level 28)

Last Updated: 13 December, 2023