Skip to content

[EN] Website Installation

PengyuDeng edited this page Oct 17, 2024 · 32 revisions

This is a short tutorial on installing TS-website 2.0

Requirements

Show / hide

General:

  • A web server, shared hosting or dedicated server running Apache or nginx
  • Access to your web server (via shell or FTP)
  • A FTP Client (not needed if you are going with the "dummy" method)

Minimal

  • PHP 7.2 - 7.4 (PHP 8 is not yet supported)
  • Mysql 5.6 - 5.7 (Mysql 8 in not yet supported)
  • TeamSpeak server 3.10.0 (build 1564054246) or newer
  • Enabled extensions: mbstring, json, pdo_mysql, curl

Recommended configuration

  • Ubuntu 18.04+, PHP 7.2+, nginx

How to install TS-website 2 - in short

Show / hide
  1. Download the latest version from the releases page
  2. Unzip it
  3. Transfer it to the web directory
  4. Open your browser and navigate to TS-website, proceed with installation

Version for dummies - step by step with commands

Show / hide

This is a simple tutorial with commands for dummies.

What will you need:

  • Clean VPS server running Ubuntu 18.04 or later (the newer version the better)
  • SSH access to the server ("putty")

Preparing system

Update apt and get some necessary packages

sudo apt-get update
sudo apt-get install unzip

Installing web server, PHP and database

Please follow DigitalOcean's great tutorial for this.

After you get back:

Check PHP version:

php -v

Your PHP version must be 7.2 or greater.

Install some additional PHP packages:

sudo apt-get install php-mbstring php-curl

Get into MySQL: sudo mysql or sudo mysql -u root -p, provide your password.

Create the database and quit MySQL:

CREATE DATABASE tswebsite;
exit

Installing TS-website

  1. Go to the releases page and copy the link to the latest release zip (like this)
  2. Choose how would you like to install TS-website:

In a root folder (for example https://wruczek.tech)

cd /var/www/html
sudo wget paste_the_release_zip_link_here
sudo unzip ts-website-*.zip
sudo rm ts-website-*.zip
sudo mv -v ts-website/* .
sudo rmdir ts-website
sudo chown www-data:www-data -R .

In a sub-directory (for example https://wruczek.tech/ts-website)

cd /var/www/html
sudo wget paste_the_release_zip_link_here
sudo unzip ts-website-*.zip
sudo rm ts-website-*.zip
sudo chown www-data:www-data -R ts-website

That's it!

Visit your website in web browser again to start the installation process.
If you have installed TS-website in a sub-directory, remember to visit http://your-server/ts-website

Have fun!


Admin status config

Show / hide

In the config, simply add the group IDs under the adminstatus_groups. Add commas ONLY between the IDs (it's JSON)

[6,59,23,40]

Assigner config format

Show / hide

Until the admin panel is released, use this as a template example for the assigner.
Copy and paste it into the config table, under assignerConfig.

[
    {
        "name": "Country",
        "icon": "fas fa-globe",
        "max": 1,
        "groups": [
            6,
            59,
            12,
            11,
            388
        ]
    },
    {
        "name": "4 fun",
        "icon": "fas fa-gamepad",
        "max": 3,
        "groups": [
            14,
            15,
            620,
            61,
            625,
            18
        ]
    }
]

Hosting the font-end libraries yourself (no external dependencies)

Show / hide

You will need to find, download, and host the files yourself.

Rough explanation can be found here.

Clone this wiki locally