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.
- 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`
- 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!
- 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

- Copy following folders to the target machine:
files
logs
- 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.