update to internal commit a34f0f04

Author: DMGithubPublisher

_articles/extended-usage/dynamsoft-service-configuration.md

@@ -10,17 +10,58 @@ description: Dynamic Web TWAIN SDK Documentation Dynamic Web TWAIN Service Page
 
 # Configuring the Dynamic Web TWAIN Service
 
-> This article is meant exclusively for the Desktop Service Edition of Dynamic Web TWAIN.
+The Dynamic Web TWAIN Service is the core piece of Dynamic Web TWAIN. It handles the communication between hardware (scanner, webcam, etc.) and browser, manages the image buffer, and coordinates data between different modules.
 
-The Dynamic Web TWAIN Service is the core piece of Dynamic Web TWAIN when running in Service mode. It handles the communication between hardware (scanner, webcam, etc.) and browser, manages the image buffer, and coordinates data between different modules.
+
+## Installation of Dynamic Web TWAIN Service
+
+On a desktop, when a new user accesses a web page using Dynamic Web TWAIN SDK for the first time, he will be prompted to install the Dynamic Web TWAIN Service. This is a built-in behavior of the library. The prompt will display the download link. Once the installer is downloaded, the installation process will take just a few seconds.
+
+The prompt comes up when you try to [create a WebTwain instance](/_articles/extended-usage/advanced-initialization.md#instantiating-webtwain-without-onwebtwainready).
+
+![Initialization](/assets/imgs/Initialization-1.png)
+
+On **Windows and macOS**, double click the downloaded installer to install the service. 
+
+On **Linux**, instead of double clicking, the downloaded installer needs to be run using one of the following commands:
+
+- Debian / Ubuntu
+
+  ```bash 
+  sudo dpkg -i DynamicWebTWAINServiceSetup.deb
+  ```
+
+- Fedora
+
+  ```bash 
+  sudo rpm -ivh DynamicWebTWAINServiceSetup.rpm
+  ```
+
+Once the installation is done, the users can click the orange sentence 'click here to verify completion' or refresh the page to start using Dynamic Web TWAIN.
+
+![Initialization](/assets/imgs/Initialization-2.png)
+
+## Installation Folder
+
+The service is installed in the following folders on different platforms by default.
+
+- Windows:
+  - version 19.0 and later: `C:\Program Files (x86)\Dynamsoft\Dynamic Web TWAIN Service {versionnumber}`
+  - version 18.5.1 and earlier: `C:\Windows\SysWOW64\Dynamsoft\DynamsoftServicex64_{versionnumber}`)
+- macOS: 
+  - version 19.2 and later: `/Users/{username}/Applications/Dynamsoft/Dynamic Web TWAIN Service {versionnumber}`
+  - version 19.0-19.1: `/Applications/Dynamsoft/Dynamic Web TWAIN Service {versionnumber}`
+  - version 18.5.1 and earlier: `/Applications/Dynamsoft/DynamsoftServicex64_{versionnumber}/{installed version No.}`)
+- Linux: 
+  - version 19.0 and later:  `/opt/dynamsoft/Dynamic Web TWAIN Service {versionnumber}`
+  - version 18.5.1 and earlier: `/opt/dynamsoft/DynamsoftService`
 
 ## IP and ports
 
 The Dynamic Web TWAIN Service uses `localhost` and `18622` `18625` ports for HTTP connection and `18623` `18626` ports for HTTPS connection.  
-These ports can be configured in the `DSConfiguration.ini` file located in:
-  - Windows: `C:\Program Files (x86)\Dynamsoft\Dynamic Web TWAIN Service {versionnumber}`(version 18.5.1 and earlier `C:\Windows\SysWOW64\Dynamsoft\DynamsoftServicex64_{versionnumber}`)
-  - macOS: `Go > Applications > Dynamsoft > Dynamic Web TWAIN Service {versionnumber}`(version 18.5.1 and earlier `Go > Applications > Dynamsoft > DynamsoftServicex64_{versionnumber} > {installed version No.}`)
-  - Linux: `/opt/dynamsoft/Dynamic Web TWAIN Service {versionnumber}`(version 18.5.1 and earlier `/opt/dynamsoft/DynamsoftService`)
+
+These ports can be configured in the `DSConfiguration.ini` file located in the service's installatin folder.
+
 
 ## Access-Control-Allow-Origin
 
@@ -58,33 +99,40 @@ When a request comes from a different origin, a CORS error message will be displ
 
   ![CORS-error-console](/assets/imgs/CORS-error-console.png)
 
-## Installation of Dynamic Web TWAIN Service
 
-On a desktop, when a new user accesses a web page using Dynamic Web TWAIN SDK for the first time, he will be prompted to install the Dynamic Web TWAIN Service. This is a built-in behavior of the library. The prompt will display the download link. Once the installer is downloaded, the installation process will take just a few seconds.
+## Web Setup
 
-The prompt comes up when you try to [create a WebTwain instance](/_articles/extended-usage/advanced-initialization.md#instantiating-webtwain-without-onwebtwainready) in Service mode.
+The service provides a web page to know its status and make basic configurations. You can access it through <http://127.0.0.1:18625>.
 
-![Initialization](/assets/imgs/Initialization-1.png)
+For security reasons, the web setup is disabled by default. You can add the following line to `DSConfiguration.ini` to enable it.
 
-On **Windows and macOS**, double click the downloaded installer to install the service. 
+```
+EnableWebSetup=TRUE
+```
 
-On **Linux**, instead of double clicking, the downloaded installer needs to be run using one of the following commands:
+Screenshots:
 
-- Debian / Ubuntu
+* Default:
 
-  ```bash 
-  sudo dpkg -i DynamicWebTWAINServiceSetup.deb
-  ```
+   ![home](/assets/imgs/service-web-setup/home.jpg)
 
-- Fedora
+* External Access Tab:
 
-  ```bash 
-  sudo rpm -ivh DynamicWebTWAINServiceSetup.rpm
-  ```
+   ![external access setup](/assets/imgs/service-web-setup/external-access-setup.jpg)
 
-Once the installation is done, the users can click the orange sentence 'click here to verify completion' or refresh the page to start using Dynamic Web TWAIN.
+On the left of the page, you can check the service's status and update the [`LogLevel`](/_articles/info/api/WebTwain_Util.md#loglevel)。
+
+On the right of the page, you can configure the service through the local access tab and the external access tab.
+
+In the local access tab, you can update the SSL certificate for domains bound to `127.0.0.1`.
+
+In the external access tab, you can update the following settings:
+
+1. Host: configure an external IP so that it can be accessed by other devices.
+2. Firewall exception: add exception rules to the firewall to avoid the traffic being blocked by the firewall (only for Windows).
+3. Domain: bind a domain to the IP of your service and configure its SSL certificate.
+4. Bonjour service: enable Bonjour service to allow service discovery in local networks. It is needed for the [Remote Scan solution](https://www.dynamsoft.com/remote-scan/docs/introduction/).
 
-![Initialization](/assets/imgs/Initialization-2.png)
 
 ## Msg: Dynamic Web TWAIN Service is not installed / Dynamic Web TWAIN is not installed
 

_articles/faq/DVS-is-not-defined.md

@@ -7,6 +7,7 @@ keywords: Dynamic Web TWAIN, Error Troubleshooting, DVS
 breadcrumbText: Uncaught ReferenceError - DVS is not defined
 description: Uncaught ReferenceError - DVS is not defined
 date: 2021-12-03 23:26:46 +0800
+last_modified: 2023-10-11 00:56:56 +0800
 ---
 
 # Error Troubleshooting

_articles/faq/HTTP-process-error.md

@@ -7,6 +7,7 @@ keywords: Dynamic Web TWAIN, Error Troubleshooting, HTTP process
 breadcrumbText: HTTP process error
 description: HTTP process error
 date: 2021-12-03 23:26:46 +0800
+last_modified: 2025-08-14 14:09:35 +0800
 ---
 
 # Error Troubleshooting
@@ -77,8 +78,26 @@ When attempting to upload images using any of the HTTPUpload\*\*\* methods the u
     </configuration>
     ```
 
-    If you are using `PHP` , you can change the value in the following line in the `php.ini` file:
+    If you are using `PHP` , you can change the value in the following lines in the `php.ini` file and `web.config` file:
+
+    - **php.ini**
 
     ```shell
-    upload_max_filesize = 2M
+    file_uploads = On            ; Enable file uploads
+    upload_max_filesize = 50M    ; Max single file size for uploads
+    post_max_size = 60M          ; Max size for POST data (includes all fields and files)
+    max_execution_time = 300     ; Max script execution time (in seconds)
+    ```
+
+    - **web.config**
+
+    ```xml
+    <system.webServer>
+        <security>
+            <requestFiltering>
+                <requestLimits maxAllowedContentLength="52428800" /><!-- 50MB -->
+            </requestFiltering>
+        </security>
+    </system.webServer>
     ```
+

_articles/faq/HTTP-request-error.md

@@ -7,6 +7,7 @@ keywords: Dynamic Web TWAIN, Error Troubleshooting, HTTP request
 breadcrumbText: HTTP request error
 description: HTTP request error
 date: 2021-12-03 23:26:46 +0800
+last_modified: 2022-06-02 15:30:49 +0800
 ---
 
 # Error Troubleshooting

_articles/faq/JPEG-compression.md

@@ -7,6 +7,7 @@ keywords: Dynamic Web TWAIN, Error Troubleshooting, jpeg, 24-bit, 8-bit
 breadcrumbText: Only 24-bit true color bmp and 8-bit gray-scaled images are supported for JPEG compression
 description: Only 24-bit true color bmp and 8-bit gray-scaled images are supported for JPEG compression
 date: 2020-12-10 16:11:49 +0800
+last_modified: 2024-09-19 08:47:35 +0800
 ---
 
 # Error Troubleshooting

_articles/faq/XMLHttpRequest-cannot-load.md

@@ -7,6 +7,7 @@ keywords: Dynamic Web TWAIN, Error Troubleshooting, XMLHttpRequest
 breadcrumbText: XMLHttpRequest cannot load XXX
 description: XMLHttpRequest cannot load XXX
 date: 2021-12-03 23:26:46 +0800
+last_modified: 2022-06-02 15:30:49 +0800
 ---
 
 # Error Troubleshooting

_articles/faq/acquireimage-sync-or-async.md

@@ -7,6 +7,7 @@ keywords: Dynamic Web TWAIN, Capture/ Image Source, acquireImage synchronous, as
 breadcrumbText: Is the AcquireImage() method synchronous or asynchronous?
 description: Is the AcquireImage() method synchronous or asynchronous?
 date: 2021-12-08 03:01:32 +0800
+last_modified: 2022-06-10 04:40:03 +0800
 ---
 
 # Capture/Image Source

_articles/faq/activeX-in-Edge-IE-mode.md

@@ -7,6 +7,7 @@ keywords: Dynamic Web TWAIN, ActiveX, Internet Explorer mode, IE mode
 breadcrumbText: How to run Dynamic Web TWAIN ActiveX in Microsoft Edge Internet Explorer (IE) mode
 description: How to run Dynamic Web TWAIN ActiveX in Microsoft Edge Internet Explorer (IE) mode
 date: 2022-04-22 05:24:12 +0800
+last_modified: 2022-10-14 14:05:08 +0800
 ---
 
 View all FAQs about [Project Deployment and End-user Installation](

_articles/faq/add-annotation-to-image.md

@@ -8,6 +8,7 @@ breadcrumbText: Can I add annotation to an image (e.g. add watermark or text)?
 description: Can I add annotation to an image (e.g. add watermark or text)?
 date: 2021-12-09 09:25:33 +0800
 last_modified: 2025-05-20 09:25:33 +0800
+
 ---
 
 # Image Editing

_articles/faq/additional-form-fields.md

@@ -7,6 +7,7 @@ keywords: Dynamic Web TWAIN, Document Saving, additional form fields
 breadcrumbText: How can I send additional form fields with images to my server or database?
 description: How can I send additional form fields with images to my server or database?
 date: 2021-11-29 18:33:59 +0800
+last_modified: 2024-09-19 08:47:35 +0800
 ---
 
 # Document Saving