SSH to your server. Then perform the following procedure:

  • Install libraries

    apt-get update
    apt-get install wget openssl libncurses5
  • Install Erlang

    We will install erlang from repository published on Erlang Solutions site.

    wget http://packages.erlang-solutions.com/erlang-solutions_1.0_all.deb
    dpkg -i erlang-solutions_1.0_all.deb
    apt-get update
    apt-get install erlang-nox
  • Install BossTDS

    1. Download and install bosstds package for your distro from this page:

      wget http://bosstds.com/static/distr/bosstds_4.9.4_all.deb
      dpkg -i bosstds_4.9.4_all.deb

      Now if everything went ok, your tds should already be running.

    2. If you have a firewall, like IPTables, ensure that it does not block outgoing connections to lic1.bosstds.com:443 and lic2.bosstds.com:443. These are license servers.

    3. Point 'A' record of your domail or subdomain to the IP of your server and try to connect to BossTDS admin panel from your browser. http://yourtds.yourdomain.com:18001/ for example. By default BossTDS listens on 18001 port.
      If you see a "Create new account" page - everything works fine. If not - be patient, and wait for a couple of minutes as the first run could take some time while the app creates nessessary tables.
      Create new admin account and log in to control panel.

    4. IMPORTANT: If you have more than 1 IP on your server, navigate to Tools->Settings menu and set one of these IPs in the field 'Bind to IP'.

    5. Navigate to http://yourtds.yourdomain.com:18001/ and click 'Validate License' button. In a few seconds you will see if BossTDS can connect to license servers or not.

    Your TDS is ready now and works in trial mode.

Run on 80 port

You can run BossTDS on standard 80 (http) port, so that instead of http://yourtds.yourdomain.com:18001/ you could use http://yourtds.yourdomain.com. It has its' own web server after all.
There are two ways to do this - Simple and Reverse Proxy.


You may use Simple mode if you 100% sure that there will be no other http servers such as Apache or Nginx which run on 80 port on this box.
If you're going to run Apache or Nginx on the same server where BossTDS is installed and run BossTDS on 80 port in the same time - skip to Reverse Proxy section.

  • Run on 80 port, simple
    1. Edit your boss.config file

      nano /opt/bosstds/boss.config

      Find {port, 18001} option and change 18001 to 80.
      Find {reverse_proxy, off} option and ensure that it is off. Default value is off.
      Save the file with 'Ctrl+X', 'Y', Enter

    2. Restart the BossTDS

      /etc/init.d/bosstds restart
  • Run on 80 port, Reverse Proxy mode behind Nginx or Apache2

    Nginx is the recommended server if you're going to run BossTDS in reverse proxy mode. It is always recomended to have Nginx in front of BossTDS, just in case.

    Apache is not recomended as reverse proxy, under heavy load it will slow down your TDS and will eat lots of RAM. Still it is possible to use it if you really want to.

    Both Nginx and Apache require the same configuration of BossTDS.

    SSH to your server. Then perform the following procedure:

    1. Edit your boss.config file

      nano /opt/bosstds/boss.config

      Find {reverse_proxy, off} option and set it to on: {reverse_proxy, on}.
      Save the file with 'Ctrl+X', 'Y', Enter

    2. Restart the BossTDS

      /etc/init.d/bosstds restart
    Nginx server configuration:
        upstream bosstds  {
              server 127.0.0.1:18001;
        }
        server {
                listen 80;
                server_name yourtds.yourdomain.com; #<- insert here your real domain name
                set_real_ip_from  127.0.0.1;
                access_log off;
                location /static/ {
                    root /opt/bosstds/priv/;
                }
                location / {
                        proxy_pass  http://bosstds;
                        proxy_redirect off;
                        proxy_buffering off;
                        proxy_set_header        Host            $host;
                        proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    
                }
        }
    
    Apache2 Virtual host configuration:
    <VirtualHost *:80>
            ProxyPreserveHost       On
            ProxyRequests           off
            ProxyPass               /       http://127.0.0.1:18001/ keepalive=Off
            ProxyPassReverse        /       http://127.0.0.1:18001/
    
            #replace with your real domain
            ProxyPassReverseCookieDomain 127.0.0.1 yourtds.yourdomain.com
    
            #replace with your real domain
            ServerName yourtds.yourdomain.com
    </VirtualHost>
    

If you have any problems you can always contact our support. We will help you to setup your server and install the TDS on it. It is free and with no obligations.

www.megastock.ru www.paypal.com www.paxum.com
Hide dock Show dock Back to top
Loading