Install & Upgrade

Change License or Upgrade From Trial/Old Version

NOTE: For only license changing, please click Update License

To upgrade Dynamic Web TWAIN from trial or an old version to the latest full version, please follow the steps below.


If you are upgrading from a very old version (at least 2 major versions apart like from v12 to v15), more steps may be needed, feel free to contact Dynamsoft Support Team for more information.

For the developer
Basic Steps
# Step 1 Update Resources on the Development machine

NOTE: if you are using version 16.0 and don't plan to upgrade / downgrade to any other version, you can skip this step.

## a) Uninstall the trial/old version
> **Windows**: Search Dynamic Web TWAIN in `Control Panel -> Programs and Features`, and remove all the relevant components there.
> **macOS**: Execute `Applications > Dynamsoft > Dynamic Web TWAIN SDK {Version Number} > Uninstall.pkg`
## b) Install the latest full version
The download link of the full version can be found in the purchasing email that was sent to the registered email/purchaser’s email. If you purchased the SDK but lost the download link of the full version, please [request the download]( again.
## c) Replace the whole Resources folder of Dynamic Web TWAIN in your application with the Resources folder of the full version. Typically, you can find it at the following path
> **Windows**: `C:\Program Files (x86)\Dynamsoft\Dynamic Web TWAIN SDK {Version Number}`
> **macOS**: `Applications > Dynamsoft > Dynamic Web TWAIN SDK {Version Number}`
# Step 2 Update the License
## a) Replace the product key
In the file `dynamsoft.webtwain.config.js`, search for `Dynamsoft.WebTwainEnv.ProductKey` and input the product key(s) you received.

Dynamsoft.WebTwainEnv.Containers = [{ContainerId:'dwtcontrolContainer', Width:270, Height:350}];
Dynamsoft.WebTwainEnv.ProductKey = 't0076lQAAAGNcO61He******;t0076lQAAAGNcO61He******';
## b) If the key you set is the purchased full version key, then you should also set Dynamsoft.WebTwainEnv.Trial to false if it's true.
In the file `dynamsoft.webtwain.config.js`, search for `Dynamsoft.WebTwainEnv.Trial`, and set it to `false` manually.

> The above step b is not required if you are using **version 16.0**.
# Step 3 Deploy the full version to the server

After you have finished the testing on your dev machines, you can update your application on the server accordingly.

For the end users

If you are prompted to download and install a new version, follow the instructions to complete the upgrade. Then the service will be reconnected or you can refresh your browser. For more info, check out Client-side Installation.

Install on the Client Machines

Dynamic Web TWAIN runs 100% on the client-side, every client machine needs to install its components in order to use the SDK. Over the years, Dynamsoft has made many efforts to make the process as smooth as possible. Here we'll talk about how the installation is done in version 15.0 (latest as of June, 2019).

When the client first visit the web page which has Dynamic Web TWAIN implemented, the automatic initialization of the SDK which is built in its JavaScript library will try to establish connection with the Dynamsoft Service which is expected to be installed locally.

NOTE: the initialization happens after the DOMContentLoaded event fires.

Should the connection fails, it means the service is not installed and the following prompt will come up and ask the end user to download and install the service.


NOTE: the same prompt will appear no matter whether the client OS is Windows, macOS or Linux. But the file you download differs on different Systems. On Windows and macOS, the users can double click the downloaded installer to install the SDK. On Linux, however, the users will need to run either one of the following command to install it

Debian / Ubuntu

dpkg -i DynamsoftServiceSetup.deb


rpm -ivh DynamsoftServiceSetup.rpm

Once the installation is done, you can click 'Reconnect to the service' or refresh the page to start using the SDK.


Install/Uninstall Silently

To silently install Dynamsoft Service via Command Line, you need to first have the file DynamsoftServiceSetup.msi which can be found in the installation folder of Dynamic Web TWAIN which is typically located at

C:\Program Files (x86)\Dynamsoft\Dynamic Web TWAIN SDK {Version No.} {Trial}\Resources\dist\win

Please run the CMD as administrator, and enter the following line of code with the relevant .msi name.

C:\Users\{User}\{DWT Path}>msiexec /i DynamsoftServiceSetup.msi /quiet

To silently uninstall Dynamic Web TWAIN, you can replace the /i parameter with /x.

C:\Users\{User}\{DWT Path}>msiexec /x DynamsoftServiceSetup.msi /quiet

If you want to create an install/uninstall log, you can use a command line which looks like this:

C:\Users\{User}\{DWT Path}>msiexec /x DynamsoftServiceSetup.msi /quiet /L*V "C:\log\example.log"

If you can't find the .msi, feel free to contact Dynamsoft Support Team.

Note: if you are a system administrator, you can also use the .msi to remotely install the software to all the end-user machines through Group Policy. Check out the article from Microsoft.

Uninstall on the Client Machines

On Windows
  1. Remove Dynamsoft Service (Trial) through Control Panel, if you see anything named like "Dynamsoft " or "Dynamic Web TWAIN ", Then remove them as well.
  2. Remove the folder C:\Windows\SysWOW64\Dynamsoft\DynamsoftService C:\Windows\SysWOW64\Dynamsoft\DynamsoftService and C:\Windows\SysWOW64\Dynamsoft\DynamsoftServicex64 together with all files under it.
On macOS

Run the file Uninstall.pkg to uninstall it. The file can be found in Go > Applications > Dynamsoft > WebTwain > {installed version No.} >

On Linux

Run the file to uninstall it. The file can be found in opt/dynamsoft/DynamsoftService

results matching ""

    No results matching ""

    results matching ""

      No results matching ""