Minimum Server Spec
2 CPU Cores
Windows installs have been tested and verified on the following version:
Windows 10, 11
Windows Server 2016, 2019, 2022
Note: VT Docs requires port 443 for users to access the application from web browser.
Installing VT Docs
To install VT Docs on Windows download the .exe file from here:
To verify that the download was completed successfully, you can check the hash:
certutil -hashfile vtdocs_windows-5_0_5.exe MD5
The valid SHA256 Hash is: b7744d9a725d60c8ba5dc73617e5ebe3
VT Docs requires a HTTP server. There are two ways to deploy VT Docs with a HTTP Server:
- Install Apache HTTP server as part of the VT Docs installation
- Use Windows IIS server and configure it to work with VT Docs.
Install Using Apache Web Server
Run the install file and follow the install wizard instructions. Install instructions to note are the steps of installing a web server as a reverse proxy. If you wish to use Apache web server make sure the box is checked. All configuration for Apache web server will be done as part of the install.
Install Using IIS
If you wish to use IIS as a reverse proxy and for SSL termination make sure to uncheck the "Apache" box. We do NOT configure IIS as part of the install. Once the install wizard has finished, please follow this guide to configure IIS to work with VT Docs: IIS As Reverse Proxy For VT Docs
Install VT Docs with PostgreSQL installed on another Drive
The default install of VT Docs installs all components on the same Drive. If you wish to install PostgreSQL on a different drive, follow the instruction below. Otherwise, please ignore this section.
- Run the vtdocs_windows.exe file
- Uncheck PostgreSQL
After Docs installs, open cmd(command prompt) and install postgresql with the args in the command below:
C:\Program Files\VisibleThread\vtdocs\setup\postgresql-14.2-2-windows-x64.exe --mode unattended --superpassword <customer_to_provide> --servicename <customer_managed_pg_service> --prefix <customer_directory_path> --datadir <customer_provided>
- After PostgreSQL is installed using the above, download SQL files below.
- Run the following command to configure the database. Note, psql has to be run from the postgresql install directory\bin
-W in the first command will prompt you for the password you created at install via --superpassword
-W in the second command will prompt you for the password you created in the first psql command via -v pwd="''"
psql -U postgres -W -f "\path\to\createDocsDB.sql" -v pwd="'asecurepassword'"
psql -U vtdocs -W -f vtdocs-tables.sql
- Update the context.xml file located at C:\Program Files\VisibleThread\vtdocs\tomcat\conf\context.xml to match the database User, DB and password created above. The two lines that need to be edited should look like this:
username="vtdocs" password="yourpasswordhere" maxTotal="20" maxIdle="10" maxWaitMillis="-1"
Note "yourpasswordhere" is the password you set with the first psql command above
Lastly, just restart the vtdocs-tomcat service. Type Services into the search bar and scroll until you find vtdocs-tomcat, select it and click Restart
If you have any issue with your installation, please contact us at email@example.com