Web Document Management in Chrome OS

Since version 17.1, Dynamic Web TWAIN has supported Chrome OS, in addition to Windows, Linux, macOS, and Raspberry Pi OS.

This guide applies to versions 17.1 through 19.x. It covers installation, version-specific package names, and post-installation configuration such as certificate handling and host settings.

Demo Video: Chrome OS Document Management

Version Note: Installation Package Name Change

  • v17.1 – <19.0: the package name is DynamsoftServiceSetup.deb
  • v19.0+: the package name is DynamicWebTWAINServiceSetup.deb

Throughout this article, substitute the correct package name depending on your version.

Experience the Online Demo

Try the free Dynamic Web TWAIN online demo directly on Chrome OS.

On first visit, you’ll be prompted to download the Debian package (*.deb) required for Chrome OS.

download Dynamic Web TWAIN for Chrome OS

After downloading, the file will be saved to the Downloads folder. Install it using the Linux (Crostini) environment.

Installing Dynamic Web TWAIN Service on Chrome OS

  1. Go to Settings > Developers and enable the Linux development environment. Wait for setup to finish.
  2. A Linux terminal and a Linux files folder will appear.
  3. When you connect a document scanner, click the CONNECT TO LINUX notification so it’s exposed to the Linux container.

Installation Steps

  1. Copy the .deb file from Downloads to Linux files.
    • v17.1 – <19.0: DynamsoftServiceSetup.deb
    • v19.0+: DynamicWebTWAINServiceSetup.deb

  2. Install SANE (scanner access):

     sudo apt update sudo apt install sane
  3. Install the Dynamic Web TWAIN service (use the correct filename): 
     # v17.1 - <19.0 sudo dpkg -i DynamsoftServiceSetup.deb # v19.0 and later sudo dpkg -i DynamicWebTWAINServiceSetup.deb

    If dependencies are missing:

     sudo apt -f install
  4. Tip: Avoid using the file manager option “Install with Linux” for this package—it may not handle dependencies correctly.

Verify Service

Check if the service is running:

ps aux | grep -i dynamsoft

Post-Installation: Enabling Secure Communication

After installation, JavaScript must communicate with the local service over HTTPS. There are two ways to enable this:

Option 1: Add a Certificate Exception for 127.0.0.1

  1. Visit: https://127.0.0.1:18623
  2. The browser will warn about the self-signed certificate. Add an exception to allow it.
  3. Reload your web application.

Option 2: Use the Provided Certificate (local.dynamsoft.com)

Dynamic Web TWAIN includes a certificate for local.dynamsoft.com. Point the SDK host there.

If your project has dynamsoft.webtwain.config.js, set:

Dynamsoft.DWT.Host = "local.dynamsoft.com";

If no config file exists (e.g., framework samples via NPM), set the host before initialization:

Dynamsoft.DWT.Host = "local.dynamsoft.com"; Dynamsoft.DWT.Load(); // or your initialization call

Trying the Web Document Management Application

Reload the demo page. Once the service is installed and secure communication is enabled, the experience on Chrome OS will match that of other desktop platforms.

Dynamic Web TWAIN for Chrome OS

Summary

  • Installed the appropriate service package for your version (17.1–19.x).
  • Verified the service is running.
  • Enabled secure communication either by adding a localhost certificate exception or configuring local.dynamsoft.com.

You can now build and run document management apps on Chrome OS just like on Windows, macOS, or Linux.