Automate all update processes for your TeamSpeak 3 server instances
GPL-3.0 License
TS3UpdateScript is the most used bash-script by companies to automate and optimize the TeamSpeak 3 server update process. This is the fastest script to run this task.
Show TS3UpdateScript Best Practices
The script checks if a newer version of TeamSpeak 3 server is available. If yes, you can choose if the script updates your server. You also set parameters like "delete old logs files" and so on.
If you don't want to update your TeamSpeak 3 server manually, you can use this script. This script follows all of the steps to properly update your TeamSpeak 3 server.
TS3UpdateScript is free software and is made available free of charge. Your donation, which is purely optional, supports me at improving the software as well as reducing my costs of this project. If you like the software, please consider a donation. Thank you very much!
If you are using systemd to ensure, that your TeamSpeak server instance is running, you should add a condition to your systemd script to avoid automated restarts while the TS3UpdateScript is performing an update.
The TS3UpdateScript creates a temporary file called .ts3updatescript.lock
in the root directory (where you also can find the ts3server_startscript.sh
script) of the TeamSpeak server instance, when it starts updating the instance. As soon as it finished the update, it deletes this lock file again.
You can use this lock file to tell systemd to avoid automated restarts while the TS3UpdateScript is performing an update. Simply add a condition to systemd: ConditionPathExists=!/home/teamspeak/.ts3updatescript.lock
Here is a full example:
[Unit]
Description=TeamSpeak Server
After=network.target
ConditionPathExists=!/home/teamspeak/.ts3updatescript.lock
[Install]
WantedBy=multi-user.target
Alias=teamspeak-server.service
[Service]
User=teamspeak
Group=teamspeak
WorkingDirectory=/home/teamspeak/
ExecStart=/home/teamspeak/ts3server_startscript.sh start
ExecStop=/home/teamspeak/ts3server_startscript.sh stop
ExecReload=/home/teamspeak/ts3server_startscript.sh restart
PIDFile=/home/teamspeak/ts3server.pid
Restart=always
Type=forking
Verified:
Need Review:
We cannot translate this script into each language. But you can help us achieve better language support by creating a new language file with your language! Please send your translation to our email address above, then we can add your translation to the next version. As thank you we will name you in this document, if you would like.
Just grab a copy of your language file, which you understand and translate the content between the two quotation marks. If you think it is ok, you can send us this file via email and we will add it to the TS3UpdateScript. You also can check it in the GitHub Project as new "Issue".
All you need to do to get the list of available options/parameters is:
user@tux:~$ sudo ./TS3UpdateScript --help
All you need to do to execute an update process is:
user@tux:~$ sudo ./TS3UpdateScript --check
You also can use the tab auto-completion of this script, which will be installed after the first execution of the TS3UpdateScript and a relog of the Linux user:
user@tux:~$ sudo ./TS3UpdateScript --check --[TAB][TAB]
user@tux:~$ sudo ./TS3UpdateScript --check --dele[TAB]
Multi usable parameters can be combined, while single usable can just be used without any other parameter(s). The order of any parameter is irrelevant - you can use them as you want to.
Parameter | Description |
---|---|
--check | Checks, if a newer version for your instance is available |
--delete-old-logs | Deletes old TeamSpeak 3 server logs while update process |
--inform-online-clients | Sends the configured poke message to each online client on each virtual server, that the server will be updated (if you enter 'Yes, update!') |
--keep-backups | Keep created backups by the script |
--waiting-time-in-minutes [MINUTES] | Optionally the script can wait X minutes before it starts the update process |
--disable-temporary-password-backup | Disable feature to backup temporary passwords |
--set-release | Do not use the official latest release. Use instead the set release from the given file configs/config.all |
--beta-release | With this parameter you are able to detect and update your TeamSpeak server to the latest beta release |
--path | Specify the absolute path to the TS3 server instance, which should be updated instead of searching for all |
--locale [LANGUAGE-CODE] | Change language of this script to some of the available under languages/verified/ directory. Default is en_US. |
--debug [DEBUG_FILENAME] | Enables debugging and writes output to file |
--install-cronjob | Installs weekly cronjob for monday at 3 AM (= 03:00 O'clock) with your given options |
user@tux:~$ sudo ./TS3UpdateScript --check
user@tux:~$ sudo ./TS3UpdateScript --check --delete-old-logs
user@tux:~$ sudo ./TS3UpdateScript --check --keep-backups
user@tux:~$ sudo ./TS3UpdateScript --check --delete-old-logs --inform-online-clients
user@tux:~$ sudo ./TS3UpdateScript --check --delete-old-logs --waiting-time-in-minutes 30
user@tux:~$ sudo ./TS3UpdateScript --check --delete-old-logs --waiting-time-in-minutes 30 --inform-online-clients --keep-backups
Parameter | Description |
---|---|
-h OR --help | Displays this help page |
-v OR --version | Displays version of this script |
--display-settings | Displays settings from config files in configs/ |
--test-inform-online-clients | Execute test poke with current settings |
--update-script | Updates the TS3UpdateScript to the latest version |
--deinstall-cronjob | Deinstalls weekly cronjob |
user@tux:~$ sudo ./TS3UpdateScript -h
user@tux:~$ sudo ./TS3UpdateScript --help
user@tux:~$ sudo ./TS3UpdateScript --display-settings
user@tux:~$ sudo ./TS3UpdateScript --test-inform-online-clients
user@tux:~$ sudo ./TS3UpdateScript --update-script
First it will check if a newer version of the script is available; afterwards it will check your installed version of each instance against the latest available version from teamspeak.de. It also will detect if you are using TSDNS, SQLite or MySQL database, etc. If a newer version is available, the script will do following steps:
Those steps will execute for each installed instance of Teamspeak 3, which will be checked.
The files/ directories will not be touched by the script - also not backuped!
Protocol | Host/IP | Used for | How often? |
---|---|---|---|
https | www.teamspeak.com | For detection of latest stable server release version | Each execution of the TS3UpdateScript |
https | files.teamspeak-services.com | Download server for TeamSpeak 3 server files | Each execution of the TS3UpdateScript |
https | raw.githubusercontent.com | Server for checking latest TS3UpdateScript version | Each execution of the TS3UpdateScript |
https | github.com | Download server for TS3UpdateScript files | Only if you update the TS3UpdateScript |
Path | Description |
---|---|
. | README.md, TS3UpdateScript.sh, .updateScript.sh, .ts3updatescript |
./docs/ | Install and upgrade guide as well as changelog |
./configs/ | Configuration files |
./languages/ | Language files |
Because of the TeamSpeak 3 Server updates, customer wishes and suggestions to the script, however, constantly extended or optimized, which is the reason why it will never have a "final" version level.
The script is ready and fully functional.