Skip to content

Commit 981c625

Browse files
committed
Update README.md
1 parent e6a76ef commit 981c625

1 file changed

Lines changed: 53 additions & 4 deletions

File tree

README.md

Lines changed: 53 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,56 @@
1-
# TSN-Ranksystem
1+
# TS3 Ranksystem
2+
![compat](https://jvmerkle.de/badges/latest-tsn-rs-compat.svg) ![build](https://img.shields.io/docker/cloud/build/jvmerkle/ts3-ranksystem.svg) ![auto](https://img.shields.io/docker/cloud/automated/jvmerkle/ts3-ranksystem.svg) ![pulls](https://img.shields.io/docker/pulls/jvmerkle/ts3-ranksystem.svg)
23

3-
![license: GPL v3](https://img.shields.io/badge/license-GPL%20v3-brightgreen.svg) ![forks](https://img.shields.io/github/forks/Newcomer1989/TSN-Ranksystem.svg) ![stars](https://img.shields.io/github/stars/Newcomer1989/TSN-Ranksystem.svg) [![GitHub issues](https://img.shields.io/github/issues/Newcomer1989/TSN-Ranksystem.svg)](https://github.com/Newcomer1989/TSN-Ranksystem/issues)
4+
System that automatically grants ranks in the form of server groups for online time or online activity to users, using the given server groups of the TS3 server.
45

5-
The TSN Ranksystem is an easy to handle Level System to automatically grant ranks (servergroups) to users on a TeamSpeak Server for online time or online activity. You can create your own servergroups, with permissions, icons etc. of your choice, and define these for the Ranksystem. Its open source and so its free to use under the GNU license with version 3.
6+
This is a modified fork of the TSN-Ranksystem which is updated irregularly to a stable version. It is intended to be fully compatible to TSN-Ranksystem at all times. The changeset on branch `develop` is always rebased onto TSN-Ranksystem and later on merged into `master`.
67

7-
#### Official website: [TS-Ranksystem.com](https://ts-ranksystem.com)
8+
Please make sure that your TSN-Ranksystem (database) version is not above the (database) version of this fork (downgrade).
9+
10+
## Docker
11+
You can find the docker images on docker hub as [jvmerkle/ts3-ranksystem](https://hub.docker.com/r/jvmerkle/ts3-ranksystem).
12+
Please note that the container **MUST BE accessed via a trusted proxy server only** (e.g. nginx).
13+
Make sure to set `BASE_HREF` to the absolute URL path of the rank system (e.g. `https://foobar.com/frank/ranksystem` => `BASE_HREF=/frank/ranksystem/`) in the `docker-compose.yml`
14+
15+
### First time setup
16+
Enable the `INSTALL_MODE=1` in the file `docker-compose.yml` by uncommenting the line. Then start the rank system with:
17+
```sh
18+
docker-compose up
19+
```
20+
Navigate to the `install.php` with your browser and set up the rank system.
21+
After performing the first time setup re-edit the `docker-compose.yml` by commenting or removing the `INSTALL_MODE`.
22+
Then start the docker containers in daemon mode:
23+
```sh
24+
docker-compose up -d
25+
```
26+
27+
### Existing installation
28+
Import your database into the `ranksystem-db` container and update the `DB_NAME` of the docker compose file if required.
29+
30+
## Modifications
31+
Additions and (security) improvements to [Newcomer1989/TSN-Ranksystem](https://github.com/Newcomer1989/TSN-Ranksystem)
32+
33+
- Disabled self-updating process, which __exposes information__ to *ts-n.net* such as
34+
- TeamSpeak Statistics (e.g. users per day/week/month/quarter)
35+
- Teamspeak hostname and port (e.g. localhost / abc.xyz)
36+
- ...
37+
- The update __check__ does __not__ enforce SSL peer verification and is therefore insecure
38+
- Secure api key comparison
39+
- No unnecessary webinterface HTTPS warning for rank systems behind a proxy
40+
- Docker-Ready
41+
- Aesthetics:
42+
- Website title is set to "TS3 Ranksystem"
43+
- The favicon link is removed from the page head
44+
- "Ranksystem info" is moved from the navbar to the footer
45+
46+
## History
47+
The following patches are no longer applied (no longer required):
48+
49+
- Removal of base64 encoded "copyright checks" which reported the violation to the *ts-n.net* server:
50+
- For `info.php` page modifications
51+
- For removal of the `info.php` hyperlink from the sidebar
52+
- Removal of an April fool
53+
- CSRF protection fix
54+
55+
## License
56+
This project is licensed under the terms of the GNU General Public License v3.0.

0 commit comments

Comments
 (0)