Windows Installation

This article walks you through the installation of the SSH Gateway on Windows, either using the x86 or x64 packages provided by SSHTOOLS Limited. Once you have downloaded the appropriate file for your Windows architecture, please upload this to your server and access the server via RDP or through the console to install.


Step 1. Pre-requisites

The SSH Gateway requires a Java 7 or greater runtime installed. This is included as part of the product download so you only need to confirm that the ports you require are free. 

The server provides an administrative interface that is accessible using your browser so you should ensure that no other HTTP server is already running on the machine or you have chosen some alternative ports such as 8080/8443 for them to listen on.

Similarly an SSH server is also installed as part of this product and will attempt to listen on port 22. If you need this to co-exist with another SSH server already running on that port you can install the product as normal and change the SSH port once you have access to the administrative user interface. 


Step 2. Install

The installation is a typical installer for Windows. Guiding you through the process, prompting you for information when needed. When you first run the application you will be promoted by User Account Control to confirm the installation can make changes to your system. Click Yes to continue.

Screen_Shot_2015-08-25_at_18.31.25.png Screen_Shot_2015-08-25_at_18.31.35_copy.png


Confirm that you want to install the product on the next page and then accept the license agreement.

Screen_Shot_2015-08-25_at_18.31.55_copy.png   Screen_Shot_2015-08-25_at_18.32.07_copy.png


You will then have the option to change the default installation directory before the installation proceeds.

Screen_Shot_2015-08-25_at_18.32.21_copy.png   Screen_Shot_2015-08-25_at_18.32.30.png


You will then have the option to set the HTTP ports used by the service. Set your chosen ports and click Next. You will then have the option to setup the Start Menu folder where the link to the administrative interface will be created. Click Next when you have configured this to your choosing.

Screen_Shot_2015-08-25_at_18.33.01_copy.png   Screen_Shot_2015-08-25_at_18.33.19_copy.png


Next you will have the option to setup the database where all your settings will be stored. The default setting of Built-in should be perfectly fine for most installations. Changing the database is an Advanced option and requires further external configuration of your database. Only select these options if you are experienced with using the database selected.

After selecting the database type the installer is ready to start the service. After clicking Next the installer will wait for the service to start. It could take some time and the screen will allow up to two minutes to wait for the service to respond to HTTP requests.

Screen_Shot_2015-08-25_at_18.33.30_copy.png   Screen_Shot_2015-08-25_at_18.33.44.png


Once the service has started the installer will present you with a summary screen giving you a browser link to the administrative interface. Clicking on this link takes you to the login screen where you can login for the first time. To complete the installation click Next and then Finish on the final page.

Screen_Shot_2015-08-25_at_18.34.29_copy.png  Screen_Shot_2015-08-25_at_18.34.42_copy.png


Step 3. Stopping and Starting the Server

You can control the SSH Gateway service through the Windows Services control panel. 




You have now installed the SSH Gateway server on your Windows server. The server provides an administrative interface that runs on port 443 of the server. You can now connect to the user interface using the url https://<hostname>/ where <hostname> is the ip, hostname or FQDN of the server you have installed using this articles instructions.

You should be presented with a login screen after connecting to the URL. You should login using the default administrative credentials:

Username: admin

Password: admin

 You will be prompted to change the admin password after logging in for the first time. 

Have more questions? Submit a request


Please sign in to leave a comment.