Linux

Installation Video

Linux VPS Installation Guide
Need a VPS? Get a $100 credit on VULTR or Digital Ocean for your first 30 days.

Supported Linux distributions

To be fair, there are so many Linux distributions that we have not tested them all. We simply do not know if they all work or if there are any issues. When you are trying a Linux version which is not listed as supported then please contact the support desk. We'd like to know when something new is tried, if it works, and how well.
Please make sure that your system meets the requirements we have outlined:
The following Linux distributions have been tested and are reported to be functional:
  • Ubuntu 16.04, 18.04, 20.04
  • Arch Linux 2018.10.0
  • Debian 9
  • CentOS 7
Make sure your Linux machine has an external IP-address, internal addresses won't work! It must not look like 192.168.x.x or 10.x.x.x or from 172.16.x.x to 172.31.x.x (f.i. AWS EC2)

Supported Mono versions

To make the HTS platform work on Linux we are using the Mono framework. Since recently Microsoft has taken over the development of Mono and are pushing many updates, some updates work and some updates can give issues.
The versions of Mono have been tested and are reported to be functional:
  • v5.14.0.177
  • v5.18.0.240
  • v5.20.1.19
  • v6.4.0.198
  • v6.6.0.161
  • v6.8.0.123
Mono version 4.x.x and 6.10.x and above have been known to NOT work with the platform. Please make sure you DO NOT install them.
Should you ever need to downgrade your version of Mono, please follow the steps outlined here:
Only downgrade if necessary or recommended by Support.

Installation

Our installation begins with installing a version of Mono framework higher than 5.14.x but lower than 6.8.x. This guide assumes that you are using Ubuntu as your main OS.
Make sure you go through these steps as the root user.
Pre-installation of the Mono framework
sudo apt-get update
sudo apt-get upgrade
sudo apt install gnupg ca-certificates
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
To find out what processor your machine is running
cat /proc/cpuinfo | grep vendor_id
Intel processors will output "GenuineIntel".
Copy the command appropriate for your CPU and Ubuntu version into your Terminal
Intel-based Machine
AMD-based Machine
Ubuntu version 16:
echo "deb https://download.mono-project.com/repo/ubuntu xenial/snapshots/5.14.0.177 main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list
Ubuntu version 18:
echo "deb https://download.mono-project.com/repo/ubuntu bionic/snapshots/5.14.0.177 main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list
Ubuntu version 20 (lowest version of Mono you can downgrade to is 6.8):
echo "deb https://download.mono-project.com/repo/ubuntu focal/snapshots/6.8 main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list
Ubuntu version 16:
echo "deb [arch=amd64] https://download.mono-project.com/repo/ubuntu xenial/snapshots/5.14.0.177 main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list
Ubuntu version 18:
echo "deb [arch=amd64] https://download.mono-project.com/repo/ubuntu bionic/snapshots/5.14.0.177 main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list
Ubuntu version 20 (lowest version of Mono you can downgrade to is 6.8):
echo "deb [arch=amd64] https://download.mono-project.com/repo/ubuntu focal/snapshots/6.8 main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list
sudo apt-get install mono-complete mono-vbnc
The installation of HTS itself
tar -xzvf linux32.tar.gz
This is how we can start the platform
sudo ./Haasbot.sh
To confirm it's all working use the command below and HTS should be listed on ports 8090 and 8092.
netstat -tulpn
If you need to restart the platform, you can use either of these commands:
sudo killall mono
or
kill $(ps ax | grep mono | fgrep -v grep | awk '{ print $1 }')
Ensure that you set the below settings in MainSettings.XML which you can find in /root/HTS/Settings:
<OpenInterfaceOnStartup> to false.
<HostingAdres> to the IP address of the machine that is hosting your platform. Remember it must not look like 192.168.x.x or 10.x.x.x or from 172.16.x.x to 172.31.x.x

Setting Up HTS

You are now ready to enter your license key.
You can now proceed to insert the API key(s) for the exchange(s) that you use.

Troubleshooting

  • Start HTS in debug mode to see details printed directly to the console, like so:
    mono-service HTS.exe --debug -l:HTS.lock
  • License is invalid error - please contact support
  • Incorrect login details? Can't login to your HTS? Follow the steps outlined below:

Additional resources

Haas Trade Server Ubuntu 18.04 installation comics (Hetzner edition)
Copy link
On this page
Installation Video
Supported Linux distributions
Supported Mono versions
Installation
Setting Up HTS
Troubleshooting
Additional resources