The TDS can be run on most recent Linux distros. *BSD should be ok as well.

If your distro is compatible with Debian/Ubuntu or Centos/RHEL (i.e. your distro is deb-based or rpm-based) - refer to the guides for these systems. This page is for the systems which are neither .deb nor .rpm compatible, for example Gentoo or Arch.

You will need Erlang R15B or newer with crypto module compiled. Erlang itself requires openssl and ncurses libraries. These are pretty much standard libraries and available on any platform.
In case you have some problems with crypto from R16B+ when you have the most recent openssl installed, it is always safe to install older versions of erlang, for example R15B01.

  • Install libraries and Erlang

    You will need Erlang R15B01+ or newer with crypto module compiled. Erlang itself requires openssl and ncurses libraries. These are pretty much standard libraries and available on any platform.
    In case you have some problems with crypto from R16B+ when you have the most recent openssl installed, it is always safe to install older versions of erlang, for example R15B01, as they have no compatibility issues.

  • Install BossTDS

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

      wget http://bosstds.com/static/distr/bosstds-4.9.4.tar.gz

      Unpack this tar.gz archive into /opt/ directory.

      The TDS can be either run by '/opt/bosstds/init.sh start' or by '/opt/bosstds/bosstds start'. The latter is a standard init.d script, you may put it into /etc/init.d/ and add to runlevels so that it would autostart.

      To stop the TDS you may use either '/opt/bosstds/init.sh stop' or '/opt/bosstds/bosstds stop'. Mind you, you must always stop the TDS when your system reboots, otherwise you may lose up to 3 minutes of statistics data. If you add bosstds to runlevels, the stop command will be issued automatically.

      If you want to run bosstds on 80 port (or on any port less or equal than 1024) you must start it with root privileges.

      Be sure that bosstds have enough privileges to create/delete/upfte files in /opt/bosstds/ directory.

    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