Supported browsers

You can start with these versions of the most commonly used browsers:

  • Desktop Browsers:

    • Google Chrome’s latest version

    • Mozilla Firefox’s latest version or latest Extended Support Release (ESR)

    • Apple Safari’s latest version

    • Microsoft Edge, based on Chromium, latest version

  • Mobile Browsers:

    • On Android, Google Chrome Mobile’s latest version

    • Apple iOS Safari, latest version

Multi-touch events are supported on the aforementioned mobile browsers. Additionally, LuciadRIA touch control works on devices that support both mouse and touch events.

If your browser is not in this list and you want to know whether it is supported, please contact our Product Management via our Support Desk.

To run a LuciadRIA application, you need a web (HTTP) server. Examples are IIS, Jetty, Tomcat,or Glassfish. This is required because most browsers do not allow AJAX requests when pages are opened directly from the file system.

For your convenience, the LuciadRIA distribution is delivered with the Jetty web server to deploy and run the samples. Note that the Jetty web server is a Java program, so you need to have a working Java Runtime Environment(JRE) installed. This JRE is not included in the LuciadRIA product.


LuciadRIA TypeScript definitions are generated using the TypeScript 4.x compiler. It is recommended to use the same version in your TypeScript project to prevent compiler issues.

WebGL system requirements and limitations

WebGL system requirements

WebGL 1.0 is required to run LuciadRIA with the hardware-accelerated map in 2D or 3D. WebGL 1.0 is supported on all modern desktop browsers and recent mobile browsers. To run a WebGLMap, the browser must also support WebAssembly. The browsers supported by LuciadRIA all support WebAssembly.

LuciadRIA offers a sample that shows what features of a WebGLMap are supported on your device and browser. See samples/devicesupport/index.html to get the report. It gives you an overview of supported features, unsupported features and limitations of a WebGLMap because of the capabilities of your device and browser.

When you contact our Support Desk services with WebGL problems, please send the information provided by this sample, as well as the information provided by the browser on the graphics hardware: on Chrome, enter chrome://gpu in the address bar. On Firefox, enter about:support.

You can also verify whether your platform and browser supports WebGL through websites such as For more information about troubleshooting WebGL in your browser, see

Browsers and WebGL evolve quickly. Always make sure to:

  • Update your browser automatically

  • Install operating system updates

  • Get the latest graphics drivers from your GPU vendor

On older mobiles or tablets, WebGL support is often not available, or it is supported but fundamentally broken. More recent mobiles and tablets, on the other hand, usually have decent WebGL support and performance.

LuciadRIA WebGL maps are supported on the latest versions of:

  • Google Chrome

  • Mozilla Firefox

  • Apple Safari

  • Microsoft Edge

We highly recommend Chrome or Firefox on PC desktops and Android devices, and Safari on Apple devices.


In this section, we list capabilities that are not yet available on WebGL maps. We expect all of those limitations to be removed in future releases.

  • WebGL maps currently do not support single-image layers, such as WMSImageLayer and GoogleLayer.

  • Some styling options are not supported on WebGL maps.

Military Symbology requirements

If you want to make use of the LuciadRIA Military Symbology Component, you need a LuciadFusion server as well. The LuciadRIA Military Symbology Component depends on the availability of the LuciadFusion Pro Military Symbology Component.

As a result, some samples which make use of the military symbology component (like the COP sample) will only work correctly when a LuciadFusion server is available.

Requirements for LuciadRIA development and deployment

To try out sample changes, follow along in the tutorials, and easily develop your own application using the LuciadRIA libraries, you need the Node Package Manager (npm) version 7 or higher, and therefore also Node.js (we recommend the most recent LTS version). For more information, see

To make the LuciadRIA npm packages available for installation throughout your organization, you can publish them from your own npm registry. See Publishing LuciadRIA to a local or private npm registry.