Backup your server instance or migrate onto a new location

This thread will explain how create a backup of your current server instance and all of it’s files.
And you will see which files are needed to migrate/move your server to a new location / machine.

A simplified version exists in our FAQ but we like to offer you a step by step guide.

Fowling steps are an universal solution for every Operation System.
It does not matter if you move from Linux to Windows or to Mac OS etc.

  1. Stop the current server instance (Do not kill it! Or else you will not be able to start your new server for the next 2-3 hours!)
Shutdown your server instance (Expand to get a how to for your operation system)
  • These are official supported ways. to shutdown the whole server.
    All ways will shutdown the whole instance and will report, that slots are not used anymore.```
* All operation systems:
In the ServerQuery interface you can enter the command `serverprocessstop`

* Linux/FreeBSD shell:
The command `./ts3server_startscript.sh` stop if your server was started with `./ts3server_startscript.sh start`

* Windows:
Right-click into the Server Tray Icon -> Then press `Exit`
  1. Download the latest server from our website and install the new TS server on your target machine.
  • Don’t use a Root / Admin account for the installation!
  1. Copy following files to the target machine:
.ts3server_license_accepted
licensekey.dat
query_ip_denylist.txt
query_ip_allowlist.txt
serverkey.dat
ts3server.ini
ts3db_mariaDB.ini
ts3server.sqlitedb
  • In case of MariaDB do not forget to move your server database to the new server.
  • It could be that not all listed files do exist on your machine. Don’t worry about that :smiley:
  1. Copy following folders to the target machine:
files
logs
  1. Start the server on new location or machine.

  • Keep your backup from Step 3 (and 4 if you like). It’s always good to have a backup.
  • Do not use this How-to to make a running copy of your current server. That’s not supported. Copies will deny to start or will shutdown on their own.

Note: A Snapshot is can be used to transfer a server and it’s users, channels and permissions.

You will miss all uploaded files - as an example.

When you have access to both machines we suggest you to follow the steps above.

27 Likes

Nice post, I’m sure it will be really usefull for many community managers.

9 Likes