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!)
How to shut down your server
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:
The command ./tsserver_startscript.sh stop when your server was started with ./tsserver_startscript.sh start
Windows: Right-click into the Server Tray Icon → Then press Exit
- Download the latest server from GitHub 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:
.tsserver_license_accepted
licensekey.dat
query_ip_denylist.txt
query_ip_allowlist.txt
serverkey.dat
tsserver.ini
tsdb_mariaDB.ini
tsserver.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 used to transfer a server 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.