Hypersocket Client Installation on Linux/Unix (.sh script)


The Hypersocket client is available for Windows, Linux, and Mac operating systems. This article will show you how to install the generic Linux/Unix version of the client.



1. All users who will be using Hypersocket can have the Hypersocket Client installed and this feature should be installed on the server (from Updates, Features & Licensing->Features->Client).


The Hypersocket Client is required to be able to use VPN features and it is optional for SSO or MFT features. Installing the client requires sudo or root rights, but once installed any standard user account will be able to launch and use the client.

2. In order for the client to function on Linux or Unix you will need a minimum of Java 8 or equivalent installed.


Step 1 – Download the client

To get the client the user should first log on to the Hypersocket web interface, then click on the Downloads button in the top navbar. In the Downloads page that appears, click on the link for the SH script.


Step 2 – Installing the client

The client should be executed via the command line. To install via the command line first ensure the sh file is set to executable then run it with the below to start the GUI installer:

sudo ./hypersocket-client-jfx-unix-VERSION.sh


If you do not have a GUI, the install can be run silently with:

sudo ./hypersocket-client-jfx-unix-VERSION.sh -q

On the welcome page for the GUI install, click Next to continue.


On the license agreement page, click I accept the agreement and then click Next.


Either accept the default destination directory or click Browse to choose your own directory, then click Next.


Accept the default destination for symlinks or click Browse to choose your own directory, then click Next.


Click Next.


Enter the URL for the Hypersocket web interface. This is the same address as used in the setup wizard section, for example https://gateway.corp.local.

Click Next to continue.


The install then proceeds and the files are copied to the system.

When completed, click Finish.



Once installed, the Hypersocket Service is run automatically.


Step 3 – Launching the client

The Hypersocket client can now be found in the system Applications, launch the client, or you can launch the hypersocket-gui file in /opt/hypersocket-client-jfx. You can also pull the Hypersocket JavaFX Client file onto your taskbar for easy launching of the client.

The Hypersocket client will load at the top of the screen by default appearing similar to this.


Step 4 - Connecting to a Hypersocket server

Select the Connection option  and select the server that was entered during installation, provide your login details when prompted.


When the login completes  the client will be populated with resources from the server, you can launch these from the client.


Have more questions? Submit a request