Deploying VisibleThread in single-user mode

Deploying VisibleThread in single-user mode (VisibleThread version 2.9 and later)


VisibleThread can be deployed on an individual user's PC for standalone use. In this deployment configuration, VisibleThread is only accessible from the user's PC. It is not possible to share documents and collaborate with colleagues using this deployment configuration.


Hardware Prerequisites

To deploy in single-user mode, the user's PC must have at least 6GB of RAM, and 80GB of free hard disk space. 

Software Prerequisites

Single-user deployment of VisibleThread, requires the installation of VMWare Player.  VMWare player is a free utility provided by VMWare designed to run a VMWare virtual machine on a pc (host). Download VMWare player from here:


Note: To install VMWare Player, you must have System Administrator privileges on your PC. If you do not have System Administrator privileges, contact your IT support team for assistance.

Deployment Steps


  1. Download the VisibleThread distribution file (e.g. to your PC.
  2. Unzip the VisibleThread distribution to a folder on your PC (e.g. c:\VisibleThread\VM)
  3. Install the VMWare player application.
  4. Start the VMWare player from the windows start menu.
  5. When VMWare player starts, go to the 'File' menu, and select 'Player Preferences'.




  6. Ensure the settings in the section 'Close behavior' are set to the settings below:




  7. Close the settings dialog and select 'Open a Virtual Machine from the menu'.
  8. Navigate to the location where you extracted the VisibleThread appliance in step 2, and select the 'VisibleThread - Single User' option.




  9. When the Virtual Machine file has opened, click on the 'Play Virtual machine' menu option.
  10. If you are asked if the Virtual Machine has been moved or copied, choose 'Copied'.




  11. A new window will open and you should see the VisibleThread Server VM starting up. The startup process may take a few minutes, when it has completed you should see a screen similar to the following:




  12. The screenshot above shows the IP address of the VisibleThread server. This is the address you use in your web browser to connect to the VisibleThread server. In the screenshot above it is ''
  13. The next steps involve uploading the VisibleThread license, and configuring the VisibleThread user. To do this, open a web browser on your PC and type the following in the address bar: https://<VM IP Address>, e.g. . If you see a warning about an untrusted connection, it is safe to accept this warning. If your internet browser cannot connect to the VisibleThread server, or you get a connection error you may need to change your internet settings to allow you to connect to the VM, see the troubleshooting section at the bottom of this article for more details.
  14. When prompted for the VisibleThread admin username and password enter 'visiblethread' as the username and 'password' as the password.




  15. You should now see a screen similar to the one below, prompting you to upload your VisibleThread license. Click the 'browse' button and select the license file supplied by the VisibleThread support team and upload it to the VisibleThread server.




  16. Once the license file has uploaded successfully, click 'continue' to proceed to the VisibleThread user administration area.
  17. A 'Sandbox' in VisibleThread is essentially a collection of users, and their documents. A sandbox allows multiple users work on the same set of documents.The VisibleThread server is pre-loaded with a default sandbox, so it is not necessary to create one. To add a user to the default sandbox click on the 'Click to Add/Remove users' link .




  18. You will now see the user details screen which allows you to add/edit/remove users from your VisibleThread installation. Click on the 'Add User' menu option on the top left hand corner of the screen to add a user.




  19. Enter the user details, the user name by convention is the user's email address.




  20. After creating the user, click on the 'Admin' checkbox on the right hand side, and then click 'Update' to ensure that the user has administrator privileges over the VisibleThread documents and dictionaries.


  21. Now click on the 'Click here when finished editing users' link to return to the admin area.




  22. You should now be back at the VisibleThread Administration area. The setup of the VisibleThread application is now complete. To test that everything is working, go to the VisibleThread application login screen. To do this either click on the 'Click here to go to the VisibleThread Application' link or enter https://<VM IP Address> in the browser address bar to go to the VisibleThread application. You should see a screen similar to the one below. Note you should bookmark this page as this is the entry point to the application for normal usage.


  23. Enter the username and password for the user you created in step 18 and click 'submit'. The user should now be logged in to the VisibleThread application and should see a screen similar to the one below.




Shutting down and Starting up VisibleThread

If you have finished working with VisibleThread, or you are about to shutdown your machine, you can shutdown the VisibleThread application by either clicking on the 'X' on the upper right corner of the VisibleThread VM Ware player window, or from the VMWare player menu selecting 'Virtual Machine->Power->Power Off'. It may take a few minutes to shutdown the Virtual Machine.


To startup the VisibleThread virtual machine, you must first start the VMWare player application from the windows start menu, select the 'VisibleThread Standalone' Virtual machine from the list, and select 'Play Virtual Machine'. Again it may take a few minutes for the application to start up.


I have started the VisibleThread VM using VMWare player, but when I attempt to connect to it using my browser I get a connection error.


First of all lets check if the VM is visible to your PC:

  1. On your PC go to the start menu, select 'Run...' and type 'cmd' and press return.  
  2. Now in the command window type 'ping <VM IP address>'. e.g. 'ping' and hit return.
  3. You should see an output similar to below: 


    Reply from bytes=32 time=17ms TTL=64
  4. If you see an output similar to this, you can proceed to the next section.
  5. If the ping command was not successful, you need to log on to the VisibleThread console. To do this place your mouse in the VisibleThread console window, and at the username prompt enter 'visiblethread' and for the password enter: 'password'.
  6. You should now be logged in to the VisibleThread Server console.
  7. At the command prompt type the following:
    sudo rm /etc/udev/rules.d/70-persistent-net.rules
    sudo reboot
    if you are prompted for the VisibleThread username and password use 'visiblethread' and 'password'
  8. Once the VisibleThread VM has restarted, you should see a new IP address on the console window. Open up your browser enter https://<VM IP address> in the address bar.
  9. If you can now connect to the VisibleThread server, you should resume the deployment procedure. Otherwise, continue with the troubleshooting steps below.


Depending on network setup, your PC may be configured to route all requests from your web browser through a web proxy. If this is the case, it will not be able to connect to the VisibleThread VM. To fix this issue, you can configure your internet settings to bypass the proxy when connecting to the VisibleThread VM. The steps for making this change in Internet Explorer are outlined below. Note depending on your setup, these steps may need to be performed by somebody with administrator privileges on your PC:

  1. Open Internet Explorer, and from the 'Tools' menu select 'Internet Options'
  2. Click on the 'Connections' tab, and click on 'Lan Settings'
  3. If the 'User a proxy server for your LAN' option is checked, click on the 'Advanced' button.


  4. In the advanced area add an entry for the VisibleThread VM under the 'Do not use proxy server for addresses beginning with' section




  5. Click OK and close the settings dialog.
  6. Restart Internet Explorer and in the address bar enter https://<VM IP Address> e.g.  and you should now be able to connect
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Please sign in to leave a comment.