Skip to content

FAQ

Jump to bottom
Huan He edited this page Mar 26, 2022 · 4 revisions

Browser Compatibility

Enable SSL

The File System Access API (FSA API) requires secure contexts (HTTPS) to be enabled for the website to serve MedTator through network. Therefore, to host MedTator on your own server, you need to enable SSL for your website. There are several ways to enable the SSL for your website, for example, you could use free CertBot service to get free SSL certificate. For more details, please check the CertBot homepage.

In addition to enable SSL on your own website, there are other ways to use MedTator WITHOUT manually enabling SSL:

  1. Run as a static HTML file directly from local disk. You can download the standalone version MedTator in the release page and open the standalone.html directly.
  2. Run as a localhost page. You can use our development version or other local server to host MedTator and use it for local machine only.
  3. Host MedTator on other web server that has already enabled SSL. The packaged MedTator is just one HTML file and some static JavaScript files, so you can put the MedTator code under a configured server, such as Apache and Nginx, to provide service.
  4. Use public web servers. You can use GitHub Pages service to host the program, which is how we provide public MedTator service https://ohnlp.github.io/MedTator/.

Enable File System Access API

MedTator requires File System Access API (FSA API) to be supported by your web browser to read and save annotation files on your local disk. By default, the FSA API is enabled in the latest Google Chrome and other Chromium-based browsers. But due to various factors, the FSA API may not be enabled by default in other web browsers, and thus MedTator cannot work properly. To address this issue, you need to modify the setting to enable the FSA API.

For example, in the Brave browser, according to the Brave issue discussion, you can enable the FSA API by the following steps:

  1. Upgrade to the latest Brave and start it.
  2. Navigate to brave://flags
  3. In the search box type file-system-access-api
  4. Change the File System API item's status to Enabled
  5. Click on the Relaunch button
file-system-access-api in Brave flags enable file-system-access-api in Brave flags

Once the browser restarts, re-open MedTator. If the FSA API is enabled successfully, MedTator will show the user interface correctly.

MedTator 2021-2023

Clone this wiki locally