Hardware requirements

The minimum hardware requirement for LuciadRIA is any system that’s capable of meeting the software requirements listed in this article.

Recommended hardware requirements

For new hardware purchases, we recommend the following system configuration:

  • CPU: 8-core or better

  • RAM: 16 GB or more

  • Graphics card: an NVIDIA or AMD graphics card with 4 GB of video memory or more

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 isn’t in this list and you want to know whether it’s supported, please contact our Product Management via our Support Desk.

Web server

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

For your convenience, the LuciadRIA distribution is delivered with a Jetty web server to deploy and run the samples.

Java installation

The Jetty web server that comes with the LuciadRIA distribution is a Java program, so you need to have a working Java Runtime Environment (JRE) installed. This JRE isn’t included in the LuciadRIA product. Install a JRE with Java version 17 at least.

The (optional) installer install.jar also uses this JRE.

For users of Mac computers with Apple silicon

Even though you’re using an ARM-based processor, download and install a JRE for an x86 64-bit architecture instead of an ARM-based JRE.

TypeScript

LuciadRIA TypeScript definitions are generated using the TypeScript 5.8 compiler, and are tested with older TypeScript versions. It’s recommended to keep your TypeScript compiler version up-to-date, to avoid compiler issues.

WebGPU system requirements and limitations

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

LuciadRIA includes a sample that shows what features of a RIAMap are supported on your device and browser. Navigate to the Samples page and start the LuciadRIA device support sample to get the report. It gives you an overview of supported features, unsupported features and limitations of a RIAMap because of the capabilities of your device and browser.

You can also verify whether your platform and browser supports WebGPU through websites such as http://webgpureport.org/.

Browsers and WebGPU 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, WebGPU support is often not available, or it’s supported but fundamentally broken. More recent mobiles and tablets, on the other hand, usually have decent WebGPU support and performance.

LuciadRIA 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.

For more information about setting up and troubleshooting WebGPU in your browser, see the WebGPU setup guide.

When you contact our Support Desk services with WebGPU problems, please send:

  • The information provided by the LuciadRIA device support sample

  • The information provided by the browser on the graphics hardware: on Chrome, enter chrome://gpu in the address bar. On Firefox, enter about:support.

Requirements for LuciadRIA development and deployment

NPM and Node.js

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 https://docs.npmjs.com/downloading-and-installing-node-js-and-npm.

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.

Secure context

Because LuciadRIA uses modern web technologies, such as WebGPU, your application must be served in a secure context. This means that your application must be served over HTTPS, or from localhost for development purposes. For more information, see Set up a secure context for LuciadRIA.