The installer file includes both Teamwork Cloud and Teamwork Cloud Admin in its installation package. Once the installation completes, you will have both Teamwork Cloud and Teamwork Cloud Admin installed on your machine. 


Warning

If the installation path contains any of the following characters, like '[', ']', '(', ')', '!', '@', '#', '$', '#', '%', '{', '}', '+', '=', or ';' the installation procedure cannot be completed successfully and the login page will not load. If, for example, the installation path is C:\Program Files\TeamworkCloud, which does not contain any of the special characters, the installation will not fail.


To install Teamwork Cloud by using the installer file on Windows


  1. Download the twcloud_<version_number>_installer_win64.exe file.
  2. Right click on the downloaded installer and Run as administrator. The Introduction section will open. Click Next
  3. Type the name or IP of the machine on which you want to install Teamwork Cloud and click Next.
  4. Enter the node IP. If your machine is a single node server or the first node in the cluster, enter the IP of your machine.

  5. You will be allowed to select a Java VM. Do one of the following and click Next.

    • If you want to use the Java VM provided by Teamwork Cloud, select Use the Java VM installed with this application (default).
    • If you have already had a JAVA VM installed on your machine, select Choose a Java VM already installed on this system and choose the JAVA VM from the list.
  6. Select a location on your machine where you want to install Teamwork Cloud and click Next. The Pre-Installation Summary section will open.

  7. Check if everything is correct.


  8. Click Install. The installer will install Teamwork Cloud on your machine. 

  9. Upon successful installation, click Done to close the installation window.

  10. Open the Task Manager and start the following services:

    • Teamwork Cloud service
    • WebApp service

      Zookeeper service

      The Zookeeper service starts automatically when starting the WebApp service.

  11. Check if the system is working. You should be able to access Teamwork Cloud via https://FQDN:8443/webapp/.



Post-installation configuration (optional)

The installer created a preliminary configuration. If your system is still not operational, you may need to configure the following parameters manually.

  • Edit the configuration file C:\Program Files\TeamworkCloud\configuration\application.conf. Search for contact-points =, located under the persistence esi.persistence.datastax-java-driver section, and replace localhost with ip_address_of_cassandra_node. Search for url =, located in the esi.auth section. Enter your server’s IP address or FQDN (if accessing via FQDN), for example, https://127.0.0.1:8443.
  • If you are accessing Teamwork Cloud Web UI via its FQDN:

    • Edit the configuration file C:\ProgramFiles\TeamworkCloud\WebAppPlatform\shared\conf\authserver.properties. Search for authentication.redirect.uri.whitelist and append the following to the entry: https://FQDN:8443/webapp/
    • Edit the configuration file C:\Program Files\TeamworkCloud\WebAppPlatform\shared\conf\webappplatform.properties. Add server.public.host and set it to FQDN.
    • Create an entry in C:\Windows\System32\drivers\etc\hosts containing your machine's local IP address and the FQDN. For example, if your IP address is 10.1.1.123 and your FQDN is mymachine.mydomain.local, it would be in the form

      10.1.1.123     mymachine.mydomain.local 
  • Edit the configuration file for Teamwork Cloud Admin: C:\Program Files\TeamworkCloud\WebAppPlatform\shared\conf\webappplatform.properties.

    • twc.admin.username - Set it to the username of a local account with Administrator privileges (default is Administrator).
    • twc.admin.password - Set it to the password corresponding to the Administrator user (default is Administrator).
    • If you changed the secret field in C:\Program Files\TeamworkCloud\configuration\application.conf from the default, you must modify this file accordingly. Search for authentication.client.secret. and replace the CHANGE_ME value with the same value as that in application.conf.