Skip to content

Commit fa3e0ae

Browse files
committed
Update README.md
1 parent 434c416 commit fa3e0ae

1 file changed

Lines changed: 55 additions & 4 deletions

File tree

README.md

Lines changed: 55 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,58 @@
1-
# TSN-Ranksystem
1+
# TS3 Ranksystem
2+
![docker-build](https://img.shields.io/docker/cloud/build/jvmerkle/ts3-ranksystem.svg)
3+
![docker-automated](https://img.shields.io/docker/cloud/automated/jvmerkle/ts3-ranksystem.svg)
4+
![docker-pulls](https://img.shields.io/docker/pulls/jvmerkle/ts3-ranksystem.svg)
25

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)
6+
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.
47

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.
8+
This is a modified fork of the TSN-Ranksystem which is updated irregularly to a stable version (currently **1.3.17**) . 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`.
69

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

0 commit comments

Comments
 (0)