3.x
Back to HaasOnline.comSwitch to Developer API

Linux

Installation Video

Linux VPS Installation Guide

Need a VPS? Get 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:

System Requirements

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.

Downgrading Mono

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

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
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.

License Key

You can now proceed to insert the API key(s) for the exchange(s) that you use.

Price Drivers & Accounts

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:

Lost Login Credentials

Additional resources

LogoHaas Trade Server Ubuntu 18.04 installation comics (Hetzner edition)
PreviousWindowsNextDowngrading Mono

Last updated